Configuration

The default settings should work well for most cases, but you can customize the behavior if needed.

• Define a class derived from DotNetKit.Windows.Controls.AutoCompleteComboBoxSetting to override some of its properties.
• Set the instance to AutoCompleteComboBox.Setting property.

• Or set AutoCompleteComboBoxSetting.Default to apply to all comboboxes.

Performance

Filtering allows you to add many items without losing usability, but it can affect performance. To improve this, we recommend using VirtualizingStackPanel as the items panel.

Use the ItemsPanel property:

or declare a style in resources as the Demo app does.

See also WPF: Using a VirtualizingStackPanel to Improve ComboBox Performance for more detailed explanation.

Known Issues

Shared ItemsSource

• Multiple ComboBoxes can affect each other if they share the same ItemsSource instance.
• Workaround: Use distinct ItemsSource instance for each AutoCompleteComboBox. For example, wrap it with a ReadOnlyCollection.

Filter Conflict

• Changing AutoCompleteComboBox.Filter in user code conflicts with the control's internal behavior.
• Workaround: Avoid changing Filter in user code. Filter ItemsSource instead.
• There seems to be no reliable way to merge CollectionView filters. Please let me know if you have a solution.

Background Not Applied

ComboBox doesn't appear to support the Background property. No easy fix is known.

Internals

This library is essentially a thin wrapper around the standard ComboBox with additional behaviors.

What Happens Under the Hood

• Sets IsEditable to true to allow text input
• Finds the TextBox part (in the ComboBox) to listen to the TextChanged event
• Opens or closes the dropdown when the text changes (after the debounce timer fires)
  • TextBox selection is carefully saved and restored to not disturb the user
• Filters the ComboBox items based on the input
• Handles PreviewKeyDown events (Ctrl+Space) to open the dropdown