syncfusion-winforms-multiselect-combobox
Guide for implementing the Syncfusion Windows Forms MultiSelectionComboBox control — a ComboBox with multi-item selection, auto-suggestion, and tag-style visual items. Use this skill when the user mentions MultiSelectionComboBox, WinForms multi-select combo, or Syncfusion.Windows.Forms.Tools.MultiSelectionComboBox, or needs a combo box that allows selecting multiple items in a Windows Forms application. Applies when configuring display modes, binding data sources, styling visual items, handling SelectedItemCollectionChanged, or setting AutoSuggestMode.
How do I install this agent skill?
npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-multiselect-comboboxIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides legitimate documentation and code examples for the Syncfusion MultiSelectionComboBox control. All external references and dependencies are official vendor resources and no security risks were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Implementing MultiSelectionComboBox
The MultiSelectionComboBox is a WinForms ComboBox control that supports multiple item selection and auto-suggestion. Selected items can be displayed as removable tag chips (VisualItem mode), comma-separated text (Delimiter mode), or single-value (Normal mode). It supports data binding via DataSource/DisplayMember/ValueMember, Office-style visual themes, grouping, and a rich event model.
When to Use This Skill
- Adding a multi-select dropdown to a Windows Forms application
- Displaying selected values as tag chips with close buttons
- Binding the combo box to a
DataTable,DataView, orArrayList - Configuring auto-suggestion behavior (
AutoSuggestMode) - Grouping dropdown items by initial character
- Styling the drop-down list or visual item tags
- Handling selection change and visual item collection events
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Assembly references and NuGet package setup
- Adding the control via Designer or code-behind
- Namespace imports (C# and VB.NET)
- Basic instantiation with
ButtonStyle,UseVisualStyle, andSize - Minimal working example
Display Modes & Visual Item Input
📄 Read: references/display-modes-and-visual-items.md
DisplayMode.VisualItem— tag chips with remove buttonsDisplayMode.DelimiterMode— comma-separated textDisplayMode.NormalMode— single-value selectionAutoSizeMode: Vertical, Horizontal, NoneVisualItemInputMode: DisplayMemberMode, ValueMemberMode, VisualItemMode- Delimiter character customization
Data Binding
📄 Read: references/data-binding.md
- Binding to
ArrayList,DataView, andDataTable DataSource,DisplayMember,ValueMemberproperties- Complete external data source binding example
DataSourceChangedevent handling
Styling & Customization
📄 Read: references/styling-and-customization.md
- Visual styles: Default, Office2016Colorful, Office2016White, Office2016Black, Office2016DarkGray
- Drop-down styling:
ShowCheckBox, group header colors, item/drop-down dimensions - Visual item tag colors: BackColor, ForeColor, SelectionColor, BorderColor
- Grouping:
ShowGroups, runtime enable/disable - Auto-suggestion modes:
Begin,Match,Disabled
Events & Advanced Features
📄 Read: references/events-and-advanced-features.md
SelectedItemCollectionChanged— when the selected items changeVisualItemCollectionChanged— when visual item tags are added/removedAutoSizeModeChanged,DataSourceChanged,DropDownevents- Detecting VisualItemCollection modifications at runtime
Quick Start
using Syncfusion.Windows.Forms.Tools;
using Syncfusion.Windows.Forms;
// Create and configure the control
var combo = new MultiSelectionComboBox();
combo.ButtonStyle = ButtonAppearance.Metro;
combo.UseVisualStyle = true;
combo.Size = new System.Drawing.Size(250, 30);
combo.DisplayMode = DisplayMode.VisualItem;
// Add items manually
combo.Items.AddRange(new object[] { "Apple", "Banana", "Cherry", "Date", "Elderberry" });
this.Controls.Add(combo);
Imports Syncfusion.Windows.Forms.Tools
Imports Syncfusion.Windows.Forms
Dim combo As New MultiSelectionComboBox()
combo.ButtonStyle = ButtonAppearance.Metro
combo.UseVisualStyle = True
combo.Size = New System.Drawing.Size(250, 30)
combo.DisplayMode = DisplayMode.VisualItem
combo.Items.AddRange(New Object() {"Apple", "Banana", "Cherry"})
Me.Controls.Add(combo)
Common Patterns
Bind to a DataTable and display as tag chips
DataTable dt = new DataTable();
dt.Columns.Add("ID");
dt.Columns.Add("Name");
dt.Rows.Add("1", "Alice");
dt.Rows.Add("2", "Bob");
dt.Rows.Add("3", "Carol");
combo.DataSource = dt;
combo.DisplayMember = "Name";
combo.ValueMember = "ID";
combo.DisplayMode = DisplayMode.VisualItem;
React to selection changes
combo.SelectedItemCollectionChanged += (sender, e) =>
{
if (e.Action == Actions.Added)
Console.WriteLine("Added: " + e.SelectedItems[0]);
else
Console.WriteLine("Removed: " + e.SelectedItems[0]);
};
Apply Office 2016 Colorful theme
combo.Style = MultiSelectionComboBoxStyle.Office2016Colorful;
Key Properties
| Property | Purpose |
|---|---|
DisplayMode | VisualItem / DelimiterMode / NormalMode |
AutoSuggestMode | Begin / Match / Disabled |
AutoSizeMode | Vertical / Horizontal / None |
ShowCheckBox | Show checkboxes in the dropdown |
ShowGroups | Group items by initial character |
DelimiterChar | Separator character (Delimiter mode) |
DataSource | Bind to ArrayList, DataView, DataTable |
DisplayMember | Property name shown in the control |
ValueMember | Property used as the actual value |
Style | Visual theme (Office2016Colorful, etc.) |
VisualItemInputMode | DisplayMemberMode / ValueMemberMode / VisualItemMode |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/syncfusion/winforms-ui-components-skills/syncfusion-winforms-multiselect-combobox">View syncfusion-winforms-multiselect-combobox on skillZs</a>