Click here to Skip to main content
15,879,535 members
Articles / Programming Languages / C#
Tip/Trick

ComboBox with Suggest Ability based on Substring-Search

Rate me:
Please Sign up or sign in to vote.
4.88/5 (36 votes)
5 Aug 2013CPOL2 min read 241K   7.9K   32   71
A custom ComboBox that supports live filtering of items by Substring-Search or any other Lamda-Expression

Introduction 

The WinForms ComboBox-Control offers a functionality called AutoComplete if

DropDownStyle 
is set to DropDown. There are different options available, but the focus of this article is on AutoCompleteMode = Suggest with AutoCompleteSource = ListItems. This setting provides a ListBox of suggested items when you type some text in the ComboBox.

The problem is: you cannot define the way the suggested items are filtered/determined. It's always a 'StartsWith'-search.

That's why i decided to write my own class (SuggestComboBox) based on ComboBox which looks more or less the same, but is in fact self-made. The screenshot below shows the difference: on the left hand side the input 'j' matches one more item because it's a Contains-search. 

     

The code and how it works   

At first you need a new class that inherits from ComboBox and a ListBox + BindingList as DataSource that will contain the suggested items. The filtering is done in the OnTextChanged - method via LINQ, the Lamda-Expressions for filtering and ordering can be set by the Properties FilterRule and SuggestListOrderRule (default values are a Contains-filter and ascending alphabetic order).  

To support the expected behavior for keyboard actions (UP, DOWN, ENTER, ESCAPE) you primarily need to override two methods: 

  1. OnPreviewKeyDown, that is called first when you hit a key. Here the actions to be done are listed in a switch-statement for the KeyCode.
  2. ProcessCmdKey, that is always called after the first one. Here only the base functionality is interrupted. 

The remaining methods are mainly to manage the visibility and location/size of the ListBox and need no further explanation. Just read the code! Wink | <img src= (examples are included in the zip-file)  

Update:

To support any DataSource-Type (not just string), i added the PropertySelector: you can pass the selection rule for the databound items. The default setting still assumes that a list of strings is the datasource.

Example:

C#
// assume you bind a list of persons to the ComboBox with 'Name' as DisplayMember:
suggestComboBox.DataSource = new List<person>();
suggestComboBox.DisplayMember = "Name";

// then you have to set the PropertySelector like this:
suggestComboBox.PropertySelector = collection => collection.Cast<person>().Select(p => p.Name);

// the class Person looks something like this:
class Person
{
    public string Name { get; set; }
    public DateTime DateOfBirth { get; set; }
    public int Height { get; set; }
}</person></person>

I also fixed some UI-bugs regarding the location and size of the suggest box (2 Changed-EventHandler added). 

C#
public class SuggestComboBox : ComboBox
{
    #region fields and properties
 
    private readonly ListBox _suggLb = new ListBox { Visible = false, TabStop = false };
    private readonly BindingList<string> _suggBindingList = new BindingList<string>();
    private Expression<Func<ObjectCollection, IEnumerable<string>>> _propertySelector;
    private Func<ObjectCollection, IEnumerable<string>> _propertySelectorCompiled;
    private Expression<Func<string, string, bool>> _filterRule;
    private Func<string, bool> _filterRuleCompiled;
    private Expression<Func<string, string>> _suggestListOrderRule;
    private Func<string, string> _suggestListOrderRuleCompiled;
 
    public int SuggestBoxHeight
    {
        get { return _suggLb.Height; }
        set { if (value > 0) _suggLb.Height = value; }
    }
    /// <summary>
    /// If the item-type of the ComboBox is not string,
    /// you can set here which property should be used
    /// </summary>
    public Expression<Func<ObjectCollection, IEnumerable<string>>> PropertySelector
    {
    	get { return _propertySelector; }
	set
	{
	    if (value == null) return;
	    _propertySelector = value;
	    _propertySelectorCompiled = value.Compile();
	}
    }
 
    ///<summary>
    /// Lambda-Expression to determine the suggested items
    /// (as Expression here because simple lamda (func) is not serializable)
    /// <para>default: case-insensitive contains search</para>
    /// <para>1st string: list item</para>
    /// <para>2nd string: typed text</para>
    ///</summary>
    public Expression<Func<string, string, bool>> FilterRule
    {
        get { return _filterRule; }
        set
        {
            if (value == null) return;
            _filterRule = value;
            _filterRuleCompiled = item => value.Compile()(item, Text);
        }
    }
 
    ///<summary>
    /// Lambda-Expression to order the suggested items
    /// (as Expression here because simple lamda (func) is not serializable)
    /// <para>default: alphabetic ordering</para>
    ///</summary>
    public Expression<Func<string, string>> SuggestListOrderRule
    {
        get { return _suggestListOrderRule; }
        set
        {
            if (value == null) return;
            _suggestListOrderRule = value;
            _suggestListOrderRuleCompiled = value.Compile();
        }
    }
 
    #endregion
 
    /// <summary>
    /// ctor
    /// </summary>
    public SuggestComboBox()
    {
        // set the standard rules:
        _filterRuleCompiled = s => s.ToLower().Contains(Text.Trim().ToLower());
        _suggestListOrderRuleCompiled = s => s;
        _propertySelectorCompiled = collection => collection.Cast<string>();
 
        _suggLb.DataSource = _suggBindingList;
        _suggLb.Click += SuggLbOnClick;
 
        ParentChanged += OnParentChanged;
    }
 
    /// <summary>
    /// the magic happens here ;-)
    /// </summary>
    /// <param name="e"></param>
    protected override void OnTextChanged(EventArgs e)
    {
        base.OnTextChanged(e);
 
        if (!Focused) return;
 
        _suggBindingList.Clear();
        _suggBindingList.RaiseListChangedEvents = false;
        _propertySelectorCompiled(Items)
             .Where(_filterRuleCompiled)
             .OrderBy(_suggestListOrderRuleCompiled)
             .ToList()
             .ForEach(_suggBindingList.Add);
        _suggBindingList.RaiseListChangedEvents = true;
        _suggBindingList.ResetBindings();
        
        _suggLb.Visible = _suggBindingList.Any(); 
        
        if (_suggBindingList.Count == 1 &&  
                    _suggBindingList.Single().Length == Text.Trim().Length)
        {
            Text = _suggBindingList.Single();
            Select(0, Text.Length);
            _suggLb.Visible = false;
        }
    }
 
    /// <summary>
    /// suggest-ListBox is added to parent control
    /// (in ctor parent isn't already assigned)
    /// </summary>
    /// <param name="sender"></param>
    /// <param name="e"></param>
    private void OnParentChanged(object sender, EventArgs e)
    {
        Parent.Controls.Add(_suggLb);
        Parent.Controls.SetChildIndex(_suggLb, 0);
        _suggLb.Top = Top + Height - 3;
        _suggLb.Left = Left + 3;
        _suggLb.Width = Width - 20;
        _suggLb.Font = new Font("Segoe UI", 9);
    }
 
    protected override void OnLostFocus(EventArgs e)
    {
        // _suggLb can only getting focused by clicking (because TabStop is off)
        // --> click-eventhandler 'SuggLbOnClick' is called
        if (!_suggLb.Focused)
            HideSuggBox();
        base.OnLostFocus(e);
    }
    protected override void OnLocationChanged(EventArgs e)
    {
	base.OnLocationChanged(e);
	_suggLb.Top = Top + Height - 3;
	_suggLb.Left = Left + 3;
    }
    protected override void OnSizeChanged(EventArgs e)
    {
	base.OnSizeChanged(e);
	_suggLb.Width = Width - 20;
    }
 
    private void SuggLbOnClick(object sender, EventArgs eventArgs)
    {
        Text = _suggLb.Text;
        Focus();
    }
 
    private void HideSuggBox()
    {
        _suggLb.Visible = false;
    }
 
    protected override void OnDropDown(EventArgs e)
    {
        HideSuggBox();
        base.OnDropDown(e);
    }
 
    #region keystroke events
 
    /// <summary>
    /// if the suggest-ListBox is visible some keystrokes
    /// should behave in a custom way
    /// </summary>
    /// <param name="e"></param>
    protected override void OnPreviewKeyDown(PreviewKeyDownEventArgs e)
    {
        if (!_suggLb.Visible)
        {
            base.OnPreviewKeyDown(e);
            return;
        }
 
        switch (e.KeyCode)
        {
            case Keys.Down:
                if (_suggLb.SelectedIndex < _suggBindingList.Count - 1)
                    _suggLb.SelectedIndex++;
                return;
            case Keys.Up:
                if (_suggLb.SelectedIndex > 0)
                    _suggLb.SelectedIndex--;
                return;
            case Keys.Enter:
                Text = _suggLb.Text;
	        Select(0, Text.Length);
	        _suggLb.Visible = false;
                return;
            case Keys.Escape:
                HideSuggBox();
                return;
        }
 
        base.OnPreviewKeyDown(e);
    }
 
    private static readonly Keys[] KeysToHandle  = new[] 
                { Keys.Down, Keys.Up, Keys.Enter, Keys.Escape };
    protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
    {
        // the keysstrokes of our interest should not be processed be base class:
        if (_suggLb.Visible && KeysToHandle.Contains(keyData))
            return true;
        return base.ProcessCmdKey(ref msg, keyData);
    }
 
    #endregion
} 

Remark 

One thing is really annoying i think: every time you hit ENTER or ESCAPE a 'bing'-sound is generated by the framework. I read this is a bug of .NET 4. Anybody has an idea how to fix it properly?

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Germany Germany
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionInsert the class into the project Pin
frighini5-Sep-23 4:32
frighini5-Sep-23 4:32 
BugOne more bug Pin
MrVatnik14-Nov-22 22:19
MrVatnik14-Nov-22 22:19 
QuestionNot Working!!! Pin
GuruGanesan1-Jul-20 21:40
professionalGuruGanesan1-Jul-20 21:40 
SuggestionDynamic resize of suggestListBoxHeight Pin
NobbyD31-Jul-19 22:02
NobbyD31-Jul-19 22:02 
QuestionReally good... just one question... Pin
Al Gulseth12-Jul-19 9:42
Al Gulseth12-Jul-19 9:42 
QuestionAdd mouse click event? Pin
NaumHN4-Jun-19 4:51
NaumHN4-Jun-19 4:51 
NewsFixed issues Pin
voquanghoa17-Nov-17 19:11
voquanghoa17-Nov-17 19:11 
QuestionNice work, but.. Pin
Dialecticus27-Jul-17 6:37
Dialecticus27-Jul-17 6:37 
PraiseAwesome Pin
Grck11-Jun-17 22:22
Grck11-Jun-17 22:22 
QuestionConverting this to work with a custom class Pin
Member 1239467911-Mar-17 10:08
Member 1239467911-Mar-17 10:08 
QuestionSlow Pin
tmatrai7-Mar-17 3:48
tmatrai7-Mar-17 3:48 
GeneralMy vote of 2 Pin
santosh vighne19-Jan-17 2:54
santosh vighne19-Jan-17 2:54 
GeneralMy vote of 4 Pin
Member 1289621019-Dec-16 9:23
Member 1289621019-Dec-16 9:23 
4 starts because something seems strange, the code runs fine, it works and all but my issue is with it is that each time after a run, the comboBox disappears from designer view. Only way to get it back is to clean then rebuild the code. Is there any reason for this?
GeneralRe: My vote of 4 Pin
Member 133575912-May-18 10:37
Member 133575912-May-18 10:37 
QuestionControl disappearence fix Pin
Member 121577436-Nov-16 16:35
Member 121577436-Nov-16 16:35 
QuestionOnPreviewKeyDown - Keys.Enter Pin
Member 1228117624-Feb-16 23:33
Member 1228117624-Feb-16 23:33 
GeneralMy vote of 4 Pin
Jon_Bailey21-Feb-16 10:26
professionalJon_Bailey21-Feb-16 10:26 
SuggestionOutstanding piece of work. Very grateful, plus some suggestions... Pin
Sjackson2081-Oct-15 3:16
Sjackson2081-Oct-15 3:16 
GeneralRe: Outstanding piece of work. Very grateful, plus some suggestions... Pin
GreatBasil3-Dec-15 23:05
GreatBasil3-Dec-15 23:05 
GeneralAppreciation Pin
Parth Pandya18-Jun-15 19:56
Parth Pandya18-Jun-15 19:56 
QuestionMy vote for 10 Pin
dongdemarco26-Apr-15 15:20
dongdemarco26-Apr-15 15:20 
QuestionThis is a bag of "Awesome" Pin
Kenny-A24-Mar-15 13:21
Kenny-A24-Mar-15 13:21 
QuestionHow to change width of the dropdown? Pin
chiragxyz12316-Dec-14 2:50
chiragxyz12316-Dec-14 2:50 
AnswerRe: How to change width of the dropdown? Pin
HarrySolsem20-Jan-15 22:34
HarrySolsem20-Jan-15 22:34 
Questionuse another thread not main thread for this control Pin
4L4K111-Dec-14 12:24
4L4K111-Dec-14 12:24 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.