HandyControl中CheckComboBox控件使用注意事项

问题现象分析

在使用HandyControl的CheckComboBox控件时，开发者可能会遇到一个常见问题：当尝试通过SelectedItems.Add()方法设置默认选中项时，系统会抛出"无法绑定"的异常提示。这个问题在HandyControl 3.5.0及3.5.1版本中出现，而在3.4.0版本中则表现正常。

问题本质

这个问题的核心在于CheckComboBox控件的ItemsSource和SelectedItems属性之间的绑定冲突。在WPF开发中，当使用ItemsSource属性绑定数据源时，直接操作SelectedItems集合可能会导致绑定系统出现混乱。

解决方案

官方建议的正确做法是避免直接操作SelectedItems集合，而是使用ListBoxAttach特性来实现双向绑定功能。这种方式更加符合WPF的MVVM模式，能够更好地维护数据绑定的一致性。

具体实现方法

1. 数据绑定方式：

var rs = AuthDb.db.Queryable<RoleBase>().Where(o => !o.IsAdmin).ToList();
checkComboBox.ItemsSource = rs;
checkComboBox.DisplayMemberPath = nameof(RoleBase.Name);
checkComboBox.SelectedValuePath = nameof(RoleBase.Id);

2. 替代SelectedItems.Add()的方法： 应该通过数据绑定或者ViewModel中的属性来管理选中状态，而不是直接操作UI控件的SelectedItems集合。

版本兼容性说明

这个问题在HandyControl 3.4.0版本中不存在，但在3.5.x版本中引入。开发者如果遇到此问题，可以考虑以下方案：

• 降级到3.4.0版本
• 采用推荐的ListBoxAttach方式实现功能
• 等待后续版本修复此兼容性问题

最佳实践建议

1. 遵循MVVM模式，避免在代码后台直接操作UI控件的集合属性
2. 对于多选控件，优先考虑使用绑定方式管理选中状态
3. 在升级HandyControl版本时，注意测试与选中项相关的功能
4. 查阅官方文档了解控件属性的正确使用方式

通过采用这些最佳实践，可以避免类似的绑定冲突问题，使应用程序更加稳定可靠。