【愚公系列】2023年09月 WPF控件专题 ListBox控件详解

原创

愚公搬代码

修改于 2023-09-29 13:27:51

9920

🏆 作者简介，愚公搬代码 🏆《头衔》：华为云特约编辑，华为云云享专家，华为开发者专家，华为产品云测专家，CSDN博客专家，阿里云专家博主，腾讯云优秀博主，掘金优秀博主，51CTO博客专家等。 🏆《近期荣誉》：2022年CSDN博客之星TOP2，2022年华为云十佳博主等。 🏆《博客内容》：.NET、Java、Python、Go、Node、前端、IOS、Android、鸿蒙、Linux、物联网、网络安全、大数据、人工智能、U3D游戏、小程序等相关领域知识。 🏆🎉欢迎 👍点赞✍评论⭐收藏

🚀前言

WPF控件是Windows Presentation Foundation（WPF）中的基本用户界面元素。它们是可视化对象，可以用来创建各种用户界面。WPF控件可以分为两类：原生控件和自定义控件。

原生控件是由Microsoft提供的内置控件，如Button、TextBox、Label、ComboBox等。这些控件都是WPF中常见的标准用户界面元素。

自定义控件则允许开发人员使用XAML和C#等编程语言来创建个性化的用户界面元素。自定义控件可以根据需求提供更多的功能和自定义化选项，以及更好的用户体验。

🚀一、ListBox控件详解

ListBox是WPF中常用的控件之一，用于展示列表形式的数据。

以下是ListBox控件的一些基本属性和用法：

ItemsSource：指定ListBox的数据源，可以是任何实现了IEnumerable接口的对象。
ItemTemplate：用于定义ListBox中每个项的样式。
SelectedItem：用于获取或设置ListBox中当前选中的项。
SelectionMode：用于设置ListBox中的选择模式，包括Single、Multiple等。
IsSynchronizedWithCurrentItem：用于指定ListBox是否和数据源中的当前项同步。
ScrollViewer.HorizontalScrollBarVisibility和ScrollViewer.VerticalScrollBarVisibility：用于设置ListBox中滚动条的可见性。
ListBoxItem：ListBox中每一个项都是一个ListBoxItem，可以通过定义ListBoxItem的样式来自定义ListBox的外观。

使用ListBox控件的基本步骤如下：

在XAML文件中，使用ListBox标签创建ListBox控件。
给ListBox控件设置ItemsSource属性，指定数据源。
使用ItemTemplate属性定义每个项的样式。
可选地，使用其它属性自定义ListBox的外观和交互。

例如，以下代码演示了如何使用ListBox控件展示一个字符串列表：

<ListBox ItemsSource="{Binding MyList}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding}" Margin="5"/>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

其中，MyList是ViewModel中的一个字符串列表，通过绑定的方式将其作为ListBox的数据源。ItemTemplate中定义了每个项的样式，这里使用TextBlock展示每个字符串，Margin属性设置了每个项的边距。

🔎1.属性介绍

常用的ListBox控件属性：

ItemsSource：绑定数据源集合。
SelectedItem：获取或设置ListBox中所选的项。
SelectionMode：指定选择模式（Single，Multiple，Extended）。
ItemTemplate：指定ListBox中每个项的展示模板。
IsSynchronizedWithCurrentItem：指示ListBox是否跟踪其所包含的集合中当前项的位置。
ScrollViewer.HorizontalScrollBarVisibility：指定水平滚动条的显示方式。
ScrollViewer.VerticalScrollBarVisibility：指定垂直滚动条的显示方式。
VirtualizingStackPanel.IsVirtualizing：指示是否启用虚拟化以提高性能。
VirtualizingStackPanel.VirtualizationMode：指定虚拟化模式（Standard，Recycling）。

还有很多其他的属性可供使用，可以根据实际需要进行设置。

🔎2.常用场景

WPF中ListBox控件的常用场景包括：

显示列表/集合数据：ListBox可以方便地显示任意类型的集合数据，例如字符串、图片等等。
多项选择：ListBox可以允许用户选择多个项目，这对于需要选择多项数据的情况非常有用。
上下文菜单：ListBox可以为每个项目提供上下文菜单，这样用户可以方便地执行某些操作，例如删除、重命名等等。
拖放：ListBox支持拖放操作，用户可以将项目从一个ListBox控件拖到另一个ListBox控件或其他控件中。
数据绑定：ListBox可以方便地绑定数据，例如绑定到数据库中的数据、XML文件中的数据等等。

ListBox是WPF中非常重要的控件之一，可用于许多不同的应用程序场景。

🔎3.具体案例

<Grid>
    <ListBox Name="lbClasses" SelectionMode="Multiple" ItemsSource="{Binding}"  HorizontalAlignment="Left" Height="253" Margin="136,63,0,0" VerticalAlignment="Top" Width="263" SelectionChanged="LbClasses_SelectionChanged">
        <!--<ListBoxItem Content="软件班" IsSelected="True" ></ListBoxItem>
        <ListBoxItem Content="数据班" ></ListBoxItem>
        <ListBoxItem Content="英语班" ></ListBoxItem>-->
    </ListBox>
</Grid>

private void Window_Loaded(object sender, RoutedEventArgs e)
{
    //绑定数据源
    // lbClasses.ItemsSource = GetClassInfos();
    lbClasses.DataContext = GetClassInfos();
    lbClasses.DisplayMemberPath = "ClassName";
    lbClasses.SelectedValuePath = "ClassId";
    lbClasses.SelectedIndex = 0;

    //如果要动态添加、移除项，情况与ComboBox 
    //lbClasses.Items.Add(11);
    //lbClasses.Items.Add("aaaa");

}

private List<ClassInfo> GetClassInfos()
{
    List<ClassInfo> list = new List<ClassInfo>();
    list.AddRange(new ClassInfo[]
    {
         new ClassInfo()
        {
            ClassId=1,
            ClassName="计算机一班"
        },
         new ClassInfo()
        {
            ClassId=2,
            ClassName="计算机二班"
        },
         new ClassInfo()
        {
            ClassId=3,
            ClassName="商务英语一班"
        },
          new ClassInfo()
        {
            ClassId=3,
            ClassName="商务英语二班"
        }
    });
    return list;
}

private void LbClasses_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    //选择项类型  由绑定或添加时数据的类型决定
   // MessageBox.Show(lbClasses.SelectedItem.ToString());//字符串 int
    //实体类型
    ClassInfo selItem = lbClasses.SelectedItem as ClassInfo;

}