#### [PromptPlus](PromptPlus.md 'PromptPlus')
### [PromptPlusLibrary](PromptPlusLibrary.md 'PromptPlusLibrary')
## ISelectControl\ Interface
Provides a fluent API for configuring and running a single\-selection list control\.
```csharp
public interface ISelectControl
```
#### Type parameters
`T`
The type of items shown in the list\.
### Remarks
The control renders a scrollable, optionally grouped list where the user moves the cursor
with the arrow keys and confirms with `Enter`\. Features include inline filtering
\([Filter\(FilterMode\)](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Filter(PromptPlusLibrary.FilterMode) 'PromptPlusLibrary\.ISelectControl\\.Filter\(PromptPlusLibrary\.FilterMode\)')\), optional grouped layout, history persistence \([EnableHistory\(string, Action<IHistoryOptions>\)](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.EnableHistory(string,System.Action_PromptPlusLibrary.IHistoryOptions_) 'PromptPlusLibrary\.ISelectControl\\.EnableHistory\(string, System\.Action\\)')\),
auto\-select when only one item matches the filter \([AutoSelect\(bool\)](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AutoSelect(bool) 'PromptPlusLibrary\.ISelectControl\\.AutoSelect\(bool\)')\), and view\-only
mode \([ViewOnly\(bool\)](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.ViewOnly(bool) 'PromptPlusLibrary\.ISelectControl\\.ViewOnly\(bool\)')\)\. Every configuration method returns the same
[ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance so calls can be chained \(fluent style\)\.
Call [Run\(CancellationToken\)](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Run(System.Threading.CancellationToken) 'PromptPlusLibrary\.ISelectControl\\.Run\(System\.Threading\.CancellationToken\)') last\.
### Methods
## ISelectControl\\.AddGroupedItem\(string, T, bool\) Method
Adds an item to a specific group in the list\.
```csharp
PromptPlusLibrary.ISelectControl AddGroupedItem(string group, T value, bool disable=false);
```
#### Parameters
`group` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')
The name of the group\. Cannot be `null`\.
`value` [T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')
The item to add\. Cannot be `null`\.
`disable` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, the item is disabled and cannot be selected\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [group](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddGroupedItem(string,T,bool).group 'PromptPlusLibrary\.ISelectControl\\.AddGroupedItem\(string, T, bool\)\.group') is `null`\.
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [value](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddGroupedItem(string,T,bool).value 'PromptPlusLibrary\.ISelectControl\\.AddGroupedItem\(string, T, bool\)\.value') is `null`\.
## ISelectControl\\.AddGroupedItems\(string, IEnumerable\, bool\) Method
Adds a collection of items to a specific group in the list\.
```csharp
PromptPlusLibrary.ISelectControl AddGroupedItems(string group, System.Collections.Generic.IEnumerable values, bool disable=false);
```
#### Parameters
`group` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')
The name of the group\. Cannot be `null`\.
`values` [System\.Collections\.Generic\.IEnumerable<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')
The collection of items to add\. Cannot be `null`\.
`disable` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, all items are disabled and cannot be selected\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [group](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddGroupedItems(string,System.Collections.Generic.IEnumerable_T_,bool).group 'PromptPlusLibrary\.ISelectControl\\.AddGroupedItems\(string, System\.Collections\.Generic\.IEnumerable\, bool\)\.group') is `null`\.
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [values](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddGroupedItems(string,System.Collections.Generic.IEnumerable_T_,bool).values 'PromptPlusLibrary\.ISelectControl\\.AddGroupedItems\(string, System\.Collections\.Generic\.IEnumerable\, bool\)\.values') is `null`\.
## ISelectControl\\.AddItem\(T, bool\) Method
Adds a single item to the list\.
```csharp
PromptPlusLibrary.ISelectControl AddItem(T value, bool disable=false);
```
#### Parameters
`value` [T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')
The item to add\. Cannot be `null`\.
`disable` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, the item is disabled and cannot be selected\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [value](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddItem(T,bool).value 'PromptPlusLibrary\.ISelectControl\\.AddItem\(T, bool\)\.value') is `null`\.
## ISelectControl\\.AddItems\(IEnumerable\, bool\) Method
Adds multiple items to the list\.
```csharp
PromptPlusLibrary.ISelectControl AddItems(System.Collections.Generic.IEnumerable values, bool disable=false);
```
#### Parameters
`values` [System\.Collections\.Generic\.IEnumerable<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')
The collection of items to add\. Cannot be `null`\.
`disable` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, all items are disabled and cannot be selected\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [values](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddItems(System.Collections.Generic.IEnumerable_T_,bool).values 'PromptPlusLibrary\.ISelectControl\\.AddItems\(System\.Collections\.Generic\.IEnumerable\, bool\)\.values') is `null`\.
## ISelectControl\\.AddSeparator\(SeparatorLine, Nullable\\) Method
Adds a visual separator line to the list\.
```csharp
PromptPlusLibrary.ISelectControl AddSeparator(PromptPlusLibrary.SeparatorLine separatorLine=PromptPlusLibrary.SeparatorLine.SingleLine, System.Nullable value=null);
```
#### Parameters
`separatorLine` [SeparatorLine](SeparatorLine.md 'PromptPlusLibrary\.SeparatorLine')
The type of separator line\. Default is [SingleLine](SeparatorLine.md#PromptPlusLibrary.SeparatorLine.SingleLine 'PromptPlusLibrary\.SeparatorLine\.SingleLine')\.
`value` [System\.Nullable<](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1')[System\.Char](https://learn.microsoft.com/en-us/dotnet/api/system.char 'System\.Char')[>](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1')
The character to use for the separator line\. Only used when [separatorLine](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.AddSeparator(PromptPlusLibrary.SeparatorLine,System.Nullable_char_).separatorLine 'PromptPlusLibrary\.ISelectControl\\.AddSeparator\(PromptPlusLibrary\.SeparatorLine, System\.Nullable\\)\.separatorLine') is [UserChar](SeparatorLine.md#PromptPlusLibrary.SeparatorLine.UserChar 'PromptPlusLibrary\.SeparatorLine\.UserChar')\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.AutoSelect\(bool\) Method
Automatically selects and confirms the item when filtering leaves a single selectable result\.
```csharp
PromptPlusLibrary.ISelectControl AutoSelect(bool value=true);
```
#### Parameters
`value` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, enables auto\-selection; otherwise, disables it\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.ChangeDescription\(Func\\) Method
Dynamically updates the prompt description based on the currently selected item\.
```csharp
PromptPlusLibrary.ISelectControl ChangeDescription(System.Func value);
```
#### Parameters
`value` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')
A function that receives the current item and returns the description\. Cannot be `null`\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [value](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.ChangeDescription(System.Func_T,string_).value 'PromptPlusLibrary\.ISelectControl\\.ChangeDescription\(System\.Func\\)\.value') is `null`\.
## ISelectControl\\.ChangeDescriptionAsync\(Func\\>\) Method
Dynamically updates the prompt description based on the currently selected item using an asynchronous callback\.
```csharp
PromptPlusLibrary.ISelectControl ChangeDescriptionAsync(System.Func> value);
```
#### Parameters
`value` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.Threading\.Tasks\.Task<](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[>](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')
A function that asynchronously receives the current item and returns the description\. Cannot be `null`\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [value](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.ChangeDescriptionAsync(System.Func_T,System.Threading.Tasks.Task_string__).value 'PromptPlusLibrary\.ISelectControl\\.ChangeDescriptionAsync\(System\.Func\\>\)\.value') is `null`\.
## ISelectControl\\.Default\(T, bool\) Method
Sets the initial selected item for the select control\.
```csharp
PromptPlusLibrary.ISelectControl Default(T value, bool useDefaultHistory=true);
```
#### Parameters
`value` [T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')
The initial value\. Cannot be `null`\.
`useDefaultHistory` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, uses the value from history when enabled; otherwise, uses [value](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Default(T,bool).value 'PromptPlusLibrary\.ISelectControl\\.Default\(T, bool\)\.value')\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [value](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Default(T,bool).value 'PromptPlusLibrary\.ISelectControl\\.Default\(T, bool\)\.value') is `null`\.
## ISelectControl\\.DefaultMatchBy\(Func\\) Method
Sets a custom item comparator for determining item equality\.
```csharp
PromptPlusLibrary.ISelectControl DefaultMatchBy(System.Func comparer);
```
#### Parameters
`comparer` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')
A function that compares two items and returns `true` if they are equal\. Cannot be `null`\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [comparer](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.DefaultMatchBy(System.Func_T,T,bool_).comparer 'PromptPlusLibrary\.ISelectControl\\.DefaultMatchBy\(System\.Func\\)\.comparer') is `null`\.
## ISelectControl\\.EnableHistory\(string, Action\\) Method
Enables history and applies custom configuration to the history feature\.
```csharp
PromptPlusLibrary.ISelectControl EnableHistory(string filename, System.Action? options=null);
```
#### Parameters
`filename` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')
The name of the file to store history\. Cannot be `null`\.
`options` [System\.Action<](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1')[IHistoryOptions](IHistoryOptions.md 'PromptPlusLibrary\.IHistoryOptions')[>](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1')
An action to configure [IHistoryOptions](IHistoryOptions.md 'PromptPlusLibrary\.IHistoryOptions')\. Optional\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [filename](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.EnableHistory(string,System.Action_PromptPlusLibrary.IHistoryOptions_).filename 'PromptPlusLibrary\.ISelectControl\\.EnableHistory\(string, System\.Action\\)\.filename') is `null`\.
## ISelectControl\\.ExtraInfo\(Func\\) Method
Configures the control to display additional information for each item\.
```csharp
PromptPlusLibrary.ISelectControl ExtraInfo(System.Func extraInfoNode);
```
#### Parameters
`extraInfoNode` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')
A function that takes an item of type [T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T') and returns extra information\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.ExtraInfoAsync\(Func\\>\) Method
Configures the control to display additional information for each item asynchronously\.
```csharp
PromptPlusLibrary.ISelectControl ExtraInfoAsync(System.Func> extraInfoNode);
```
#### Parameters
`extraInfoNode` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.Threading\.Tasks\.Task<](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[>](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')
A function that takes an item of type [T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T') and asynchronously returns extra information\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.Filter\(FilterMode\) Method
Sets the filtering strategy used for items in the collection\. The default is [Disabled](FilterMode.md#PromptPlusLibrary.FilterMode.Disabled 'PromptPlusLibrary\.FilterMode\.Disabled')\.
```csharp
PromptPlusLibrary.ISelectControl Filter(PromptPlusLibrary.FilterMode value);
```
#### Parameters
`value` [FilterMode](FilterMode.md 'PromptPlusLibrary\.FilterMode')
The [FilterMode](FilterMode.md 'PromptPlusLibrary\.FilterMode') to apply\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.HideTipGroup\(bool\) Method
Hides the group name hint\. The default is `false`\.
```csharp
PromptPlusLibrary.ISelectControl HideTipGroup(bool value=true);
```
#### Parameters
`value` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')
If `true`, hides the group name tip; otherwise, shows it\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.Interaction\\(IEnumerable\, Action\\>\) Method
Executes a synchronous interaction for each item in the collection\.
```csharp
PromptPlusLibrary.ISelectControl Interaction(System.Collections.Generic.IEnumerable items, System.Action> interactionAction);
```
#### Type parameters
`T1`
The type of items in the collection\.
#### Parameters
`items` [System\.Collections\.Generic\.IEnumerable<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')[T1](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Interaction_T1_(System.Collections.Generic.IEnumerable_T1_,System.Action_T1,PromptPlusLibrary.ISelectControl_T__).T1 'PromptPlusLibrary\.ISelectControl\\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\>\)\.T1')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')
The collection of items to interact with\.
`interactionAction` [System\.Action<](https://learn.microsoft.com/en-us/dotnet/api/system.action-2 'System\.Action\`2')[T1](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Interaction_T1_(System.Collections.Generic.IEnumerable_T1_,System.Action_T1,PromptPlusLibrary.ISelectControl_T__).T1 'PromptPlusLibrary\.ISelectControl\\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\>\)\.T1')[,](https://learn.microsoft.com/en-us/dotnet/api/system.action-2 'System\.Action\`2')[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[>](https://learn.microsoft.com/en-us/dotnet/api/system.action-2 'System\.Action\`2')
The action to perform on each item\. Cannot be `null`\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [interactionAction](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Interaction_T1_(System.Collections.Generic.IEnumerable_T1_,System.Action_T1,PromptPlusLibrary.ISelectControl_T__).interactionAction 'PromptPlusLibrary\.ISelectControl\\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\>\)\.interactionAction') is `null`\.
## ISelectControl\\.InteractionAsync\\(IEnumerable\, Func\,Task\>\) Method
Executes an asynchronous interaction for each item in the collection\.
```csharp
PromptPlusLibrary.ISelectControl InteractionAsync(System.Collections.Generic.IEnumerable items, System.Func,System.Threading.Tasks.Task> interactionAction);
```
#### Type parameters
`T1`
The type of items in the collection\.
#### Parameters
`items` [System\.Collections\.Generic\.IEnumerable<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')[T1](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.InteractionAsync_T1_(System.Collections.Generic.IEnumerable_T1_,System.Func_T1,PromptPlusLibrary.ISelectControl_T_,System.Threading.Tasks.Task_).T1 'PromptPlusLibrary\.ISelectControl\\.InteractionAsync\\(System\.Collections\.Generic\.IEnumerable\, System\.Func\,System\.Threading\.Tasks\.Task\>\)\.T1')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')
The collection of items to interact with\.
`interactionAction` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[T1](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.InteractionAsync_T1_(System.Collections.Generic.IEnumerable_T1_,System.Func_T1,PromptPlusLibrary.ISelectControl_T_,System.Threading.Tasks.Task_).T1 'PromptPlusLibrary\.ISelectControl\\.InteractionAsync\\(System\.Collections\.Generic\.IEnumerable\, System\.Func\,System\.Threading\.Tasks\.Task\>\)\.T1')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Threading\.Tasks\.Task](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task 'System\.Threading\.Tasks\.Task')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')
The asynchronous action to perform on each item\. Cannot be `null`\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [interactionAction](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.InteractionAsync_T1_(System.Collections.Generic.IEnumerable_T1_,System.Func_T1,PromptPlusLibrary.ISelectControl_T_,System.Threading.Tasks.Task_).interactionAction 'PromptPlusLibrary\.ISelectControl\\.InteractionAsync\\(System\.Collections\.Generic\.IEnumerable\, System\.Func\,System\.Threading\.Tasks\.Task\>\)\.interactionAction') is `null`\.
## ISelectControl\\.Options\(Action\\) Method
Applies custom options to the control\.
```csharp
PromptPlusLibrary.ISelectControl Options(System.Action options);
```
#### Parameters
`options` [System\.Action<](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1')[IControlOptions](IControlOptions.md 'PromptPlusLibrary\.IControlOptions')[>](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1')
An action to configure [IControlOptions](IControlOptions.md 'PromptPlusLibrary\.IControlOptions')\. Cannot be `null`\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
#### Exceptions
[System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException')
Thrown if [options](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.Options(System.Action_PromptPlusLibrary.IControlOptions_).options 'PromptPlusLibrary\.ISelectControl\\.Options\(System\.Action\\)\.options') is `null`\.
## ISelectControl\\.PageSize\(byte\) Method
Sets the maximum number of items displayed per page\. The default value is 0\.
Valid range is 0\-255\.
```csharp
PromptPlusLibrary.ISelectControl PageSize(byte value);
```
#### Parameters
`value` [System\.Byte](https://learn.microsoft.com/en-us/dotnet/api/system.byte 'System\.Byte')
The maximum number of items per page\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
### Remarks
A value of 0 automatically computes the page size based on screen height, reserving lines for header, footer, and pagination\.
If the provided value exceeds the available screen height \(minus reserved lines\), it is coerced to the maximum allowed value\.
## ISelectControl\\.PredicateSelected\(Func\\) Method
Sets a validation predicate that determines whether the selected item is valid\.
```csharp
PromptPlusLibrary.ISelectControl PredicateSelected(System.Func validselect);
```
#### Parameters
`validselect` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')
A predicate that returns `true` when an item is valid and can be selected\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.PredicateSelectedAsync\(Func\\>\) Method
Sets an asynchronous validation predicate that determines whether the selected item is valid\.
```csharp
PromptPlusLibrary.ISelectControl PredicateSelectedAsync(System.Func> validselect);
```
#### Parameters
`validselect` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.Threading\.Tasks\.Task<](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean')[>](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')
An asynchronous predicate that returns `true` when an item is valid and can be selected\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
### Remarks
The asynchronous predicate is evaluated synchronously \(blocking\) on the UI thread; it does not run in parallel\.
## ISelectControl\\.Run\(CancellationToken\) Method
Displays the selection list and blocks until the user confirms or cancels,
returning the highlighted item\.
```csharp
PromptPlusLibrary.ResultPrompt Run(System.Threading.CancellationToken token=default(System.Threading.CancellationToken));
```
#### Parameters
`token` [System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken')
A [System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken') used to cancel the operation\. Defaults to [System\.Threading\.CancellationToken\.None](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken.none 'System\.Threading\.CancellationToken\.None')\.
#### Returns
[PromptPlusLibrary\.ResultPrompt<](ResultPrompt_T_.md 'PromptPlusLibrary\.ResultPrompt\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ResultPrompt_T_.md 'PromptPlusLibrary\.ResultPrompt\')
A [ResultPrompt<T>](ResultPrompt_T_.md 'PromptPlusLibrary\.ResultPrompt\') containing the selected item, or an aborted result if cancelled\.
## ISelectControl\\.Styles\(SelectStyles, Style\) Method
Overrides visual styles for the select control\.
```csharp
PromptPlusLibrary.ISelectControl Styles(PromptPlusLibrary.SelectStyles styleType, ConsolePlusLibrary.Style style);
```
#### Parameters
`styleType` [SelectStyles](SelectStyles.md 'PromptPlusLibrary\.SelectStyles')
The [SelectStyles](SelectStyles.md 'PromptPlusLibrary\.SelectStyles') to apply\.
`style` [ConsolePlusLibrary\.Style](https://learn.microsoft.com/en-us/dotnet/api/consolepluslibrary.style 'ConsolePlusLibrary\.Style')
The [ConsolePlusLibrary\.Style](https://learn.microsoft.com/en-us/dotnet/api/consolepluslibrary.style 'ConsolePlusLibrary\.Style') to use\.
#### Returns
[PromptPlusLibrary\.ISelectControl<](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')[T](ISelectControl_T_.md#PromptPlusLibrary.ISelectControl_T_.T 'PromptPlusLibrary\.ISelectControl\\.T')[>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\')
The current [ISelectControl<T>](ISelectControl_T_.md 'PromptPlusLibrary\.ISelectControl\') instance for chaining\.
## ISelectControl\\.TextSelector\(Func\\) Method
Sets the function used to generate item text in the list\. By default, `ToString()` is used\.
```csharp
PromptPlusLibrary.ISelectControl