HandyControl中CheckComboBox控件使用注意事项

问题背景

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

问题分析

CheckComboBox是一个支持多选的组合框控件，它继承自ComboBox并添加了复选框功能。在WPF开发中，我们通常有两种方式来管理控件的选中项：

1. 直接操作SelectedItems集合
2. 使用数据绑定

当同时使用ItemsSource和SelectedItems时，控件内部可能会出现绑定冲突。这是因为ItemsSource通常用于数据绑定场景，而直接操作SelectedItems则属于命令式编程方式，两者混合使用会导致控件状态管理混乱。

解决方案

根据HandyControl官方建议，正确的做法是避免同时使用ItemsSource和SelectedItems。推荐使用ListBoxAttach功能来实现双向绑定，这是一种更符合WPF MVVM模式的做法。

推荐实现方式

1. 使用ListBoxAttach实现双向绑定

// XAML中
<hc:CheckComboBox ItemsSource="{Binding RoleList}" 
                 hc:ListBoxAttach.SelectedItems="{Binding SelectedRoles}"/>

// ViewModel中
public ObservableCollection<RoleBase> RoleList { get; set; }
public ObservableCollection<RoleBase> SelectedRoles { get; set; }

2. 纯MVVM方式绑定

// 绑定数据源
checkComboBox.ItemsSource = roleList;

// 使用绑定而非直接操作SelectedItems
checkComboBox.SetBinding(ListBoxAttach.SelectedItemsProperty, 
    new Binding("SelectedRoles") { Source = viewModel });

版本差异说明

在HandyControl 3.4.0版本中，直接操作SelectedItems可能不会立即报错，但这种做法本质上是不推荐的。从3.5.0版本开始，控件内部加强了绑定验证，使得这种不规范的用法会被明确提示出来，引导开发者使用更正确的方式。

最佳实践建议

1. 始终遵循MVVM模式，避免在代码后台直接操作UI控件的集合
2. 对于多选场景，使用专门的附加属性(如ListBoxAttach)来实现绑定
3. 保持数据源和选中项的同步通过绑定机制完成，而不是命令式代码
4. 当需要设置默认选中项时，应该在ViewModel中初始化SelectedRoles集合，而不是在UI层操作

通过采用这些最佳实践，可以避免绑定冲突问题，同时使代码更加清晰、可维护，也更符合WPF的设计理念。