WPF自定义过滤ComboBox问题：输入选条目后无法设置SelectedItem

我碰到过好几个类似的自定义过滤ComboBox的坑，你说的这个情况大概率是过滤逻辑和SelectedItem的同步机制没处理好，咱们一步步来修复：

核心问题分析 #

很多新手实现过滤ComboBox时，会直接把ItemsSource替换成过滤后的子集。这种做法看似简单，但会导致一个致命问题：当你从后台代码或绑定设置SelectedItem时，如果这个项不在当前的过滤子集里，控件就无法识别，自然不会显示选中状态。

正确的思路应该是：保留原始的完整数据源，用视图层（ICollectionView）做过滤，这样ItemsSource始终指向完整集合，只是视图只显示符合条件的条目，SelectedItem就能正常匹配。

具体修复步骤 #

1. 改用ICollectionView实现过滤 #

先在自定义ComboBox里保存原始数据源，通过ICollectionView来处理过滤逻辑：

// 保存原始完整数据源
private IEnumerable<object> _originalItems;
public IEnumerable<object> OriginalItems
{
    get => _originalItems;
    set
    {
        _originalItems = value;
        // 获取集合视图，用于过滤
        ItemView = CollectionViewSource.GetDefaultView(_originalItems);
        ItemView.Filter = FilterItems;
        // 把ItemsSource绑定到视图，而不是过滤后的子集
        base.ItemsSource = ItemView;
    }
}

// 用于过滤的集合视图
private ICollectionView _itemView;
public ICollectionView ItemView
{
    get => _itemView;
    set => SetProperty(ref _itemView, value);
}

// 过滤逻辑
private bool FilterItems(object item)
{
    if (string.IsNullOrEmpty(FilterText))
        return true;
    // 这里可以根据你的需求调整匹配规则（比如忽略大小写、模糊匹配）
    return item.ToString().IndexOf(FilterText, StringComparison.OrdinalIgnoreCase) >= 0;
}

// 绑定到文本框的过滤文本属性
public string FilterText
{
    get => (string)GetValue(FilterTextProperty);
    set => SetValue(FilterTextProperty, value);
}
public static readonly DependencyProperty FilterTextProperty =
    DependencyProperty.Register(nameof(FilterText), typeof(string), typeof(FilterComboBox), 
        new PropertyMetadata(string.Empty, (s, e) => ((FilterComboBox)s).ItemView?.Refresh()));

2. 同步SelectedItem和过滤文本 #

当后台设置SelectedItem或绑定更新时，需要自动同步过滤文本并重置视图，确保选中项能正常显示：

public override object SelectedItem
{
    get => base.SelectedItem;
    set
    {
        base.SelectedItem = value;
        if (value != null)
        {
            // 把过滤文本设为选中项的内容
            FilterText = value.ToString();
            // 刷新视图确保选中项可见
            ItemView.Refresh();
            // 同步文本框内容（如果模板里绑定了FilterText可以省略，但保险起见加上）
            var searchBox = GetTemplateChild("PART_SearchTextBox") as TextBox;
            searchBox?.SelectAll();
        }
        else
        {
            FilterText = string.Empty;
            ItemView.Refresh();
        }
    }
}

// 监听SelectedItem的依赖属性变化，确保绑定更新时也能同步
protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e)
{
    base.OnPropertyChanged(e);
    if (e.Property == SelectedItemProperty && e.NewValue != e.OldValue)
    {
        var selectedItem = e.NewValue as object;
        FilterText = selectedItem?.ToString() ?? string.Empty;
        ItemView?.Refresh();
    }
}

3. 修正模板里的文本框绑定 #

在自定义控件的Generic.xaml模板中，确保文本框和FilterText双向绑定，避免直接操作文本框导致的绑定冲突：

<TextBox x:Name="PART_SearchTextBox"
         Text="{Binding FilterText, RelativeSource={RelativeSource TemplatedParent}, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}"
         />

4. 处理选中后的下拉框状态 #

可选但实用：当用户选中条目后自动关闭下拉框，并确保文本框内容同步为选中项：

private void OnSelectionChanged(object sender, SelectionChangedEventArgs e)
{
    if (SelectedItem != null)
    {
        IsDropDownOpen = false;
        FilterText = SelectedItem.ToString();
    }
}

这样修改后，不管是用户手动输入过滤选择，还是后台代码设置SelectedItem、绑定更新，控件都能正确同步状态，不会出现选中项不显示的问题。

内容的提问来源于stack exchange，提问作者Coloris