Implementing ComboBoxes

This skill explains how to implement and customize the Syncfusion Windows Forms SfComboBox control.

When to Use This Skill

Use when the user needs a combobox/dropdown control in Windows Forms applications
Use when implementing autocomplete functionality with Suggest, Append, or SuggestAppend modes
Use when enabling multi-selection with checkboxes or token-based selection
Use when binding combobox to data sources (lists, databases, LINQ to SQL)
Use when implementing filtering or sorting in dropdown lists
Use when customizing dropdown appearance, watermarks, or themes
Use when adding custom controls to dropdown headers/footers
Use when implementing token-based multi-selection (chip-style inputs)

Navigation Guide

Follow the links below to open focused reference pages for each task.

Getting Started

📄 Read: references/getting-started.md

Assembly deployment and dependencies
Creating SfComboBox via designer or code
Basic data binding setup
Quick autocomplete example
Quick multi-selection example

Overview

📄 Read: references/overview.md

Component features and capabilities
Comparison with ComboBoxAdv, MultiSelectionComboBox, ComboBoxAutoComplete
API comparison table
When to use SfComboBox vs alternatives

Data Binding

📄 Read: references/data-binding.md

DataSource, DisplayMember, ValueMember properties
Binding to custom objects and collections
Binding from Microsoft Access database
Binding from LINQ to SQL classes
Complex data binding scenarios

AutoComplete

📄 Read: references/autocomplete.md

AutoCompleteMode: Suggest, Append, SuggestAppend
Case-sensitive autocomplete
AutoCompleteSuggestMode: StartsWith, Contains
Setting autocomplete delay
Complete code examples

Selection

📄 Read: references/selection.md

Single selection (SelectedIndex, SelectedValue, SelectedItem)
SelectedIndexChanged and SelectedValueChanged events
Multi-selection mode with checkboxes
Select all feature
Delimiter character customization
Tooltip for selected items
Clear button customization

Token Support

📄 Read: references/token.md

EnableToken property for chip-style selection
Token appearance customization (TokenStyle)
Adding and removing tokens
Keyboard navigation for tokens
SelectedValueChanged event for token tracking

Filtering

📄 Read: references/filtering.md

Filter property with custom predicates
RefreshFilter method
Complete filtering example
Custom filter conditions

Sorting

📄 Read: references/sorting.md

SortDescriptors property
Ascending and descending sort
Custom comparer support

Dropdown Customization

📄 Read: references/dropdown.md

MaxDropDownItems for limiting visible items
AllowDropDownResize for resize gripper
DropDownOpening and DropDownClosing events
DropDownPosition customization
DropDownWidth customization
Loading custom header/footer controls
Complete custom control example

Watermark

📄 Read: references/watermark.md

AllowNull property for null value support
Watermark text customization
WatermarkForeColor styling

Appearance & Styling

📄 Read: references/appearance.md

Visual styles and theming
BackColor, ForeColor customization
Border and font customization
Office 2016 themes

Editing

📄 Read: references/editing.md

DropDownStyle property
Edit behavior customization
Read-only mode

Item Height

📄 Read: references/item-height.md

ItemHeight property
Customizing dropdown item heights

Localization

📄 Read: references/localization.md

Culture-specific formatting
Resource file integration

UI Automation

📄 Read: references/ui-automation.md

Accessibility features
Screen reader support
Keyboard navigation

Quick Start

Minimal SfComboBox example (C#):

using Syncfusion.WinForms.ListView;

namespace WindowsFormsApp
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            
            // Create SfComboBox
            SfComboBox sfComboBox1 = new SfComboBox();
            sfComboBox1.Location = new Point(20, 20);
            sfComboBox1.Size = new Size(200, 28);
            
            // Bind data
            List<string> states = new List<string> { "Alaska", "Arizona", "California", "Colorado", "Delaware" };
            sfComboBox1.DataSource = states;
            
            this.Controls.Add(sfComboBox1);
        }
    }
}

With autocomplete:

sfComboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
sfComboBox1.AutoCompleteSuggestMode = AutoCompleteSuggestMode.Contains;

With multi-selection:

sfComboBox1.ComboBoxMode = ComboBoxMode.MultiSelection;
sfComboBox1.AllowSelectAll = true;

Common Patterns

Pattern 1: Data Binding with Custom Objects

public class USState
{
    public string LongName { get; set; }
    public string ShortName { get; set; }
}

List<USState> states = new List<USState>
{
    new USState { LongName = "California", ShortName = "CA" },
    new USState { LongName = "Texas", ShortName = "TX" }
};

sfComboBox1.DataSource = states;
sfComboBox1.DisplayMember = "LongName";
sfComboBox1.ValueMember = "ShortName";

Pattern 2: Multi-Selection with Tokens

sfComboBox1.EnableToken = true;
sfComboBox1.Style.TokenStyle.BackColor = Color.LightBlue;
sfComboBox1.Style.TokenStyle.BorderColor = Color.Blue;

Pattern 3: Custom Dropdown Header

sfComboBox1.DropDownListView.ShowHeader = true;
TextBox searchBox = new TextBox { Height = 25 };
sfComboBox1.DropDownListView.HeaderControl = searchBox;

Pattern 4: Filtering with Predicate

sfComboBox1.DropDownListView.View.Filter = (data) =>
{
    return ((USState)data).LongName.StartsWith("C");
};
sfComboBox1.DropDownListView.View.RefreshFilter();

Key Properties

Property	Type	Description
DataSource	object	Bind to IEnumerable data source
DisplayMember	string	Property name to display
ValueMember	string	Property name for value
AutoCompleteMode	enum	Suggest, Append, SuggestAppend, None
ComboBoxMode	enum	SingleSelection, MultiSelection
EnableToken	bool	Enable token-based selection
AllowSelectAll	bool	Show "Select All" in multi-select
Watermark	string	Placeholder text when empty
MaxDropDownItems	int	Max visible items in dropdown
ShowClearButton	bool	Show clear button when selected
ThemeName	string	Apply visual theme

Common Use Cases

Use Case 1: Country/State Selector

Implement a country or state dropdown with autocomplete for quick selection in address forms.

Use Case 2: Tag/Category Selection

Use multi-selection with tokens for selecting multiple tags or categories in content management systems.

Use Case 3: Searchable Dropdown

Add a search textbox in the dropdown header to filter large lists dynamically.

Use Case 4: Dependent Dropdowns

Implement cascading dropdowns where the second dropdown filters based on the first selection.

Use Case 5: Custom Item Templates

Create custom visual representations for dropdown items with images or multiple text lines.

Troubleshooting

Issue: Autocomplete not working

Solution: Ensure AutoCompleteMode is set to Suggest, Append, or SuggestAppend (not None)

Issue: Multi-selection checkboxes not showing

Solution: Set ComboBoxMode = ComboBoxMode.MultiSelection

Issue: DataSource not displaying items

Solution: Verify DisplayMember matches a public property name in your data objects

Issue: Tokens not appearing

Solution: Set EnableToken = true and select items from the dropdown

Issue: Dropdown not resizing

Solution: Check AllowDropDownResize property is true (default)

Issue: SelectedValue returns null

Solution: Ensure ValueMember is set correctly, or use SelectedItem directly

Issue: Filtering not working

Solution: Call DropDownListView.View.RefreshFilter() after setting the Filter predicate

Related Skills

implementing-syncfusion-winforms-components — parent library router

syncfusion-winforms-combobox