WPF多选模式下如何禁用ListBox中的标题项

问题描述 #

我在WPF的ListBox中创建灰色带冒号的标题项，其余列表项为黑色。需求是：当项值匹配指定类型列表中的值时，将其设为灰色标题项，并禁用该列表项使其不可点击，其余项保持可点击状态。

我编写的后台代码如下：

private void PopulateItems(List<string> items, string groupName)
{
    listbx.Items.Clear();

    List<string> itemsList = items;
    string founditemtype = null;

    foreach (string item in items)
    {
        foreach (string itemtype in Type)
        {
            if(item == itemtype)
            {
                founditemtype = itemtype;
                Label label = new Label();
                label.Content = itemtype + ":";
                label.FontWeight = FontWeights.Bold;
                label.Foreground = Brushes.Gray;

                // Handle the PreviewMouseLeftButtonDown event to prevent the grayed text to be selected:
                label.PreviewMouseLeftButtonDown += (sender, e) =>
                {
                    if (label.Content.ToString().Contains(":"))
                    {
                        e.Handled = true;
                    }
                };

                listbx.Items.Add(label);
            }
        }

        if(item != founditemtype)
        {
            listbx.Items.Add(item);
        }
}

ListBox的XAML代码：

<ListBox x:Name="listbx" BorderBrush="Black" BorderThickness="2" Grid.Row="2" VerticalAlignment="Top" HorizontalAlignment="Left" Width="525" Height="200" SelectionMode="Multiple" />

但运行程序时，即使开启多选模式，这些灰色标题项仍可被选中，包括误选情况。

错误原因 #

1. 直接添加控件到Items的问题：你把Label控件直接加入ListBox的Items集合，ListBox会将Label视为可选中的项。仅拦截PreviewMouseLeftButtonDown事件只能阻止鼠标点击触发的选中，无法应对键盘操作（比如方向键选中）、多选拖拽等场景，所以标题项还是会被选中。
2. founditemtype逻辑漏洞：在遍历每个item时，founditemtype没有每次循环重置，若前一个item是标题项，后续非标题项可能会被错误跳过；同时如果一个item匹配多个Type中的值，会重复添加标题项。

解决方案 #

正确的做法是采用WPF数据驱动的方式，通过数据模型区分项类型，结合ItemTemplate和ItemContainerStyle来控制样式和交互，从根源上禁止标题项被选中。

步骤1：定义数据模型 #

创建一个模型类来标记项是否为标题：

public class ListBoxItemModel
{
    public string Text { get; set; }
    public bool IsHeader { get; set; }
}

步骤2：重构PopulateItems方法 #

将原始字符串列表转换为模型列表，统一管理项的类型：

private void PopulateItems(List<string> items, string groupName)
{
    listbx.Items.Clear();
    var itemModels = new List<ListBoxItemModel>();

    foreach (string item in items)
    {
        // 判断当前项是否属于标题类型（Type是你的指定类型列表）
        bool isHeader = Type.Contains(item);
        itemModels.Add(new ListBoxItemModel
        {
            Text = isHeader ? $"{item}:" : item,
            IsHeader = isHeader
        });
    }

    // 绑定数据源
    listbx.ItemsSource = itemModels;
}

步骤3：修改ListBox的XAML配置 #

通过ItemContainerStyle禁用标题项的容器（ListBoxItem），通过ItemTemplate设置不同项的样式：

<Window.Resources>
    <!-- 布尔值反转转换器，用于将IsHeader转为IsEnabled的反向值 -->
    <local:BooleanNegationConverter x:Key="BooleanNegationConverter"/>
</Window.Resources>

<ListBox x:Name="listbx" BorderBrush="Black" BorderThickness="2" Grid.Row="2" 
         VerticalAlignment="Top" HorizontalAlignment="Left" Width="525" Height="200" 
         SelectionMode="Multiple">
    <!-- 设置项容器样式，禁用标题项的交互和选中 -->
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem">
            <Setter Property="IsEnabled" Value="{Binding IsHeader, Converter={StaticResource BooleanNegationConverter}}" />
            <Setter Property="Focusable" Value="{Binding IsHeader, Converter={StaticResource BooleanNegationConverter}}" />
        </Style>
    </ListBox.ItemContainerStyle>
    <!-- 设置项的渲染模板 -->
    <ListBox.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding Text}">
                <TextBlock.Style>
                    <Style TargetType="TextBlock">
                        <Style.Triggers>
                            <DataTrigger Binding="{Binding IsHeader}" Value="True">
                                <Setter Property="Foreground" Value="Gray"/>
                                <Setter Property="FontWeight" Value="Bold"/>
                            </DataTrigger>
                            <DataTrigger Binding="{Binding IsHeader}" Value="False">
                                <Setter Property="Foreground" Value="Black"/>
                            </DataTrigger>
                        </Style.Triggers>
                    </Style>
                </TextBlock.Style>
            </TextBlock>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

步骤4：添加布尔反转转换器 #

如果项目中没有这个转换器，需要添加：

using System;
using System.Globalization;
using System.Windows.Data;

public class BooleanNegationConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return value is bool boolValue ? !boolValue : value;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return value is bool boolValue ? !boolValue : value;
    }
}

方案说明 #

• 数据驱动：通过模型统一管理项的类型，避免后台直接创建控件，符合WPF的设计思想，代码更易维护。
• 容器级禁用：通过设置ListBoxItem的IsEnabled和Focusable属性，从根源上阻止标题项的选中和交互，无论鼠标还是键盘操作都无法选中。
• 样式统一控制：使用ItemTemplate和触发器设置样式，比后台逐个创建控件更高效，扩展性更强。

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