WPF ListBox控件的详细使用教程

WPF（Windows Presentation Foundation）中的ListBox控件是一个常用的控件，用于显示可选择的列表项。它可以绑定数据源、支持多选、定制项模板等。以下是ListBox控件的详细使用教程。

1. 基本用法

ListBox可以在XAML中直接定义，并通过Items属性添加项。

<ListBox Width="200" Height="100">
    <ListBoxItem>Item 1</ListBoxItem>
    <ListBoxItem>Item 2</ListBoxItem>
    <ListBoxItem>Item 3</ListBoxItem>
</ListBox>

2. 数据绑定

通常情况下，ListBox会与数据源进行绑定，而不是手动添加项。可以通过ItemsSource属性绑定一个集合。

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}"/>

在C#代码中设置数据源：

public partial class MainWindow : Window
{
    public ObservableCollection<string> MyItems { get; set; }

    public MainWindow()
    {
        InitializeComponent();
        MyItems = new ObservableCollection<string> { "Item 1", "Item 2", "Item 3" };
        this.DataContext = this;
    }
}

3. 选择模式

ListBox支持多选或单选。通过设置SelectionMode属性来控制选择模式。

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}" SelectionMode="Multiple"/>

SelectionMode的可选值有：

• Single: 只能选择一个项（默认）。
• Multiple: 可以选择多个项。
• Extended: 可以通过Shift键和鼠标组合选择多个项。

4. 定制项模板

你可以通过ItemTemplate来定义每个列表项的显示方式。使用DataTemplate来定制显示内容。

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
                <TextBlock Text="{Binding}" />
                <Button Content="Click Me" />
            </StackPanel>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

5. 响应选择事件

ListBox提供了SelectionChanged事件，当选择发生变化时，可以处理该事件。

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}" SelectionChanged="ListBox_SelectionChanged"/>

在C#代码中处理事件：

private void ListBox_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    ListBox listBox = sender as ListBox;
    string selectedItem = listBox.SelectedItem as string;
    MessageBox.Show("You selected: " + selectedItem);
}

6. 高级用法：绑定复杂对象

你可以绑定一个复杂对象的集合，并通过DisplayMemberPath属性指定要显示的对象的属性。

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}" DisplayMemberPath="Name"/>

C#代码中：

public class MyItem
{
    public string Name { get; set; }
    public int Id { get; set; }
}

public partial class MainWindow : Window
{
    public ObservableCollection<MyItem> MyItems { get; set; }

    public MainWindow()
    {
        InitializeComponent();
        MyItems = new ObservableCollection<MyItem>
        {
            new MyItem { Name = "Item 1", Id = 1 },
            new MyItem { Name = "Item 2", Id = 2 }
        };
        this.DataContext = this;
    }
}

7. 使用DataTemplateSelector动态选择模板

如果你需要根据条件动态选择DataTemplate，可以使用DataTemplateSelector。

首先定义两个模板：

<Window.Resources>
    <DataTemplate x:Key="Template1">
        <TextBlock Text="Template 1" Foreground="Red"/>
    </DataTemplate>
    <DataTemplate x:Key="Template2">
        <TextBlock Text="Template 2" Foreground="Blue"/>
    </DataTemplate>
</Window.Resources>

然后定义一个DataTemplateSelector：

public class MyTemplateSelector : DataTemplateSelector
{
    public override DataTemplate SelectTemplate(object item, DependencyObject container)
    {
        var window = Application.Current.MainWindow;
        if ((item as MyItem).Id % 2 == 0)
        {
            return window.FindResource("Template1") as DataTemplate;
        }
        else
        {
            return window.FindResource("Template2") as DataTemplate;
        }
    }
}

在ListBox中使用这个模板选择器：

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}">
    <ListBox.ItemTemplateSelector>
        <local:MyTemplateSelector/>
    </ListBox.ItemTemplateSelector>
</ListBox>

8. 排序和分组

你可以通过CollectionView对ListBox中的项进行排序和分组。首先获取集合视图：

CollectionView view = (CollectionView)CollectionViewSource.GetDefaultView(MyItems);

然后添加排序和分组规则：

view.SortDescriptions.Add(new SortDescription("Name", ListSortDirection.Ascending));
view.GroupDescriptions.Add(new PropertyGroupDescription("Category"));

9. 自定义样式

你可以通过定义样式来自定义ListBox的外观。比如：

<ListBox Width="200" Height="100" ItemsSource="{Binding MyItems}">
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem">
            <Setter Property="HorizontalContentAlignment" Value="Center"/>
            <Setter Property="Background" Value="LightGray"/>
            <Setter Property="Margin" Value="5"/>
        </Style>
    </ListBox.ItemContainerStyle>
</ListBox>

10. 虚拟化

当你有大量数据项时，可以启用虚拟化以提高性能：

<ListBox VirtualizingStackPanel.IsVirtualizing="True" VirtualizingStackPanel.VirtualizationMode="Recycling" />

虚拟化会让ListBox只渲染当前可见的项，从而减少内存占用和渲染时间。

总结

ListBox是WPF中非常强大的控件，支持多种数据绑定、模板定制和样式定制。通过灵活使用数据绑定、模板选择器和虚拟化等功能，你可以根据需求创建高效且美观的列表控件。