用途
本技能用于在 WinUI 应用中实现 Syncfusion 的 ComboBox 控件（SfComboBox），即一个功能丰富的下拉选择控件。当需要在 WinUI 应用中提供下拉选择、支持单选或多选、为下拉列表加入过滤与搜索、实现可编辑并带自动完成的下拉、将已选项展示为标记或分隔符形式、按类别对下拉项分组、自定义下拉外观、处理输入校验与无效条目，或在下拉中实现键盘导航时，可使用本技能。
主要能力
- 选择模式：支持单选与多选，多选可带复选框。
- 过滤：内置过滤，支持 StartsWith 或 Contains 模式。
- 编辑：支持可编辑与不可编辑模式，并提供自动完成。
- 显示模式：多选时支持 Token 显示或分隔符显示。
- 搜索：文本搜索并高亮结果。
- 分组：可将条目组织为类别。
- 自定义：提供丰富的模板与样式选项。
- 键盘支持：完整的键盘导航与快捷键。
- 无障碍：符合 WCAG 并支持屏幕阅读器。
使用方式
组件属于 Syncfusion 的 WinUI UI 组件，使用前需安装 NuGet 包 Syncfusion.Editors.WinUI，并在发布前更新到最新版本。基本用法是在 XAML 中声明 SfComboBox，设置 ItemsSource、DisplayMemberPath 与 TextMemberPath，并在 C# 中提供数据模型与 ViewModel。技能文档按主题组织，包含以下参考文档：getting-started.md（起步）、selection.md（选择模式）、filtering.md（过滤）、searching.md（搜索）、editing.md（编辑模式）、grouping.md（分组）、ui-customization.md（界面定制）、keyboard-and-advanced.md（键盘与高级功能）。
技能给出了若干常见实现模式，包括：可编辑下拉并带自动完成（IsEditable、IsFilteringEnabled、TextSearchMode、IsTextSearchEnabled）；多选并使用自定义分隔符（SelectionMode、MultiSelectionDisplayMode、DelimiterText，并通过 SelectedItems 访问已选项）；Token 模式并使用自定义 Token 模板（TokenItemTemplate）；处理无效输入（InputSubmitted 事件）；自定义过滤逻辑（实现 IComboBoxFilterBehavior 的 GetMatchingIndexes）；编程式选择管理（SelectedIndex、SelectedItem、SelectedItems.Add/Clear、SelectionChanged）。
关键属性按类别分为：数据绑定（ItemsSource、DisplayMemberPath、TextMemberPath、SelectedItem、SelectedItems、SelectedIndex）；选择配置（SelectionMode、MultiSelectionDisplayMode、DelimiterText、IsMultiSelectCheckBoxEnabled、SelectionChangeTrigger）；编辑与过滤（IsEditable、IsFilteringEnabled、TextSearchMode、IsTextSearchEnabled、AllowNull）；显示与界面（PlaceholderText、IsDropDownOpen、SelectionBoxItemTemplate、ItemTemplate、HeaderTemplate、FooterTemplate）；分组（GroupMemberPath）。
适用场景
技能列举的典型用例包括：国家/州两级联动下拉；博客文章标签选择（多选加 Token 显示）；可搜索的员工目录（可编辑加过滤，并显示头像等条目模板）；带分组选项的设置面板（通过 GroupMemberPath 分组）。
与其他下拉控件的选择
- 需要过滤、编辑或带 Token 的多选时使用 ComboBox。
- 需要简单单选且不可编辑时使用 DropDownList。
- 需要多选但不使用 Token（仅复选框）时使用 MultiSelect Dropdown。
- 需要输入建议但不保留下拉列表时使用 AutoComplete。
限制与安全注意事项
技能特别提示：将 ItemsSource 仅绑定到可信的内部数据源，展示前校验外部数据；不要将 Image.Source 绑定到不可信的外部 URL，应使用嵌入资源（ms-appx:///）或本地文件（file:///）；如实现 IComboBoxFilterBehavior 对接外部 API，应白名单允许的域并净化响应；在可编辑模式下校验并净化用户输入，尤其是传递给后端服务时。上述安全约束属于技能文档明确给出的限制性说明。