diff --git a/README.md b/README.md index 852f5f7..6c59229 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,30 @@ # Multiple-selection-made-easy-using-WinUI-ComboBox-control -Multiple selection made easy using WinUI ComboBox control +Syncfusion's WinUI ComboBox control enables powerful multiple selection for desktop apps. Set `SelectionMode="Multiple"` to allow users to choose multiple items. Two display modes are available: -![](MultiselectComboBox/Images/multiselect.gif) \ No newline at end of file +**Delimiter Mode:** Items separated by a custom character (e.g., comma, dash). Set via `MultiSelectionDisplayMode="Delimiter"` and customize with `DelimiterText`. + +**Token Mode:** Each item appears as a token with a close button. Set via `MultiSelectionDisplayMode="Token"`. + +## Additional features include: + +### Editable vs Non-Editable: +* **Editable:** Users can type to search and select items. +* **Non-Editable:** Users can only select from the dropdown. +* **Controlled via:** IsEditable="True" or ""False + +### Search & Filtering: + +* StartsWith and Contains filtering modes. +* Custom filtering logic can be applied. +* Highlights matching text in dropdown items + +### Customization:** + +* **ItemTemplate:** Customize how items appear in the dropdown. +* **TokenItemTemplate:** Customize how selected tokens appear. +* **Appearance:** Themes, conditional styling, dropdown height, watermark text, etc. + +## Learn more: + +* [ComboBox Overview](https://www.syncfusion.com/winui-controls/combobox) +* [Enable Multiple Selection](https://support.syncfusion.com/kb/article/15351/how-to-enable-multiple-selection-mode-in-winui-combobox)