Telerik UI for WPF

The main feature of RadAutoCompleteBox control is its AutoComplete functionality. Its behavior can be customized by setting one of the built-in modes.

Changing the AutoCompleteMode

RadAutoCompleteBox control has three built-in AutoCompleteModes - Suggest, Append, SuggestAppend. By default the AutoCompleteMode property is set to SuggestAppend.

In the next examples we will demonstrate the difference between the AutoCompleteModes:

Note

Before proceeding with next examples please read the help article about Binding To Object.

Suggest Mode

In Suggest mode after one or more matches are found they are displayed in the DropDown portion of the control.

The XAML should look like this:

CopyXAML
<telerik:RadAutoCompleteBox x:Name="autoComleteBox"  Width="200"
                            ItemsSource="{Binding Countries}"
                            DisplayMemberPath="Name" 
                            AutoCompleteMode="Suggest"/>

The next screenshots show how the control looks in Suggest mode:

radautocompletebox-features-autocomplete-1

radautocompletebox-features-autocomplete-2

radautocompletebox-features-autocomplete-3

radautocompletebox-features-autocomplete-4

Append Mode

In Append mode after one or more matches are found the DropDown portion of the control is hidden and the value in the TextBox is appended with the first matched item.

The XAML should look like this:

CopyXAML
<telerik:RadAutoCompleteBox x:Name="autoComleteBox"  Width="200"
                            ItemsSource="{Binding Countries}"
                            DisplayMemberPath="Name" 
                            AutoCompleteMode="Append"/>

The next screenshots show how the control looks in Append mode:

radautocompletebox-features-autocomplete-1

radautocompletebox-features-autocomplete-7

radautocompletebox-features-autocomplete-4

Suggest and Append Mode

SuggestAppend mode combines the behavior of the two previous modes.

Note

In this mode when input is typed in the textbox of the control the first item in the DropDown portion of the control is not highlighted and appended. The append functionality is triggered when you navigate with the keyboard to a specific item.

The XAML should look like this:

CopyXAML
<telerik:RadAutoCompleteBox x:Name="autoComleteBox"  Width="200"
                            ItemsSource="{Binding Countries}"
                            DisplayMemberPath="Name"
                            AutoCompleteMode="SuggestAppend"/>

The next screenshots show how the control looks in SuggestAppend mode:

radautocompletebox-features-autocomplete-1

radautocompletebox-features-autocomplete-5

radautocompletebox-features-autocomplete-6

radautocompletebox-features-autocomplete-4