New to Telerik UI for WPF? Download free 30-day trial

Events

The RadAutoCompleteBox exposes almost all of the TextBox events. Additionally, it provides the following events:

  • SelectionChanged: Occurs when an item of the RadAutoCompleteBox is selected. The type of the passed arguments is SelectionChangedEventArgs. You can use the readonly AddedItems and RemovedItems properties to see what item(s) were selected or deselected.

  • SearchTextChanged: Occurs when the text in the text box portion of the RadAutoCompleteBox changes. This event should be used instead of the TextChanged event. The type of the passed arguments is EventArgs.

  • Populating: Occurs when RadAutoCompleteBox starts populating its popup with items. The type of the passed arguments is CancelRoutedEventArgs meaning that you can cancel the event based on your custom logic by setting the Cancel property of the arguments to True.

  • Populated: Occurs after RadAutoCompleteBox populates its popup with items. The type of the passed arguments is EventArgs.

  • ItemsFound: Occurs when the items' search is completed. It is an event of AsyncFilteringBehavior. The type of the passed arguments is AsyncItemSearchEventArgs.

Example 1: Modify the collection with the found results from the event arguments

    public MainWindow() 
    { 
        InitializeComponent(); 
 
        var source = new List<ItemInfo>(); 
        for (int i = 0; i < 100000; i++) 
        { 
            source.Add(new ItemInfo() { Id = i }); 
        } 
        this.autoCompleteBox.ItemsSource = source; 
        var behavior = new AsyncFilteringBehavior(); 
        behavior.ItemsFound += Behavior_ItemsFound; 
        this.autoCompleteBox.FilteringBehavior = behavior; 
    } 
 
    private void Behavior_ItemsFound(object sender, Telerik.Windows.Controls.Primitives.AsyncItemSearchEventArgs e) 
    { 
        var result = (List<object>)e.Result; 
        var orderedResult = result.OfType<ItemInfo>().OrderByDescending(x => x.Id).ToList(); 
        result.Clear(); 
        foreach (var item in orderedResult) 
        { 
            result.Add(item); 
        } 
    } 

You can remove and add items from the e.Results collection or sort and filter them.

In this article