WPF 开发之旅：从 UI 基础到高级架构 (二)

十三、列表框控件ListBox与数据模版

1. 数据填充与内容属性

决定了 ListBox 中“装什么”以及“从哪儿装”。

属性名 (Property)	描述	常用用法 / 示例
`ItemsSource`	[核心] 设置或获取用于生成列表项的数据集合。这是数据绑定的入口。	`ItemsSource="{Binding StudentList}"`
`Items`	获取一个 `ItemCollection`。当不使用 `ItemsSource` 时，可手动添加项 (`ListBoxItem`)。两者互斥。	`<ListBox><ListBoxItem>A</ListBoxItem></ListBox>`
`HasItems`	(只读) 获取一个布尔值，指示 `ListBox` 是否包含任何项。	`if (myListBox.HasItems) { ... }`

2. 显示与模板属性

决定了列表中的每一项“长什么样”。

属性名 (Property)	描述	常用用法 / 示例
`DisplayMemberPath`	[快捷方式] 指定 `ItemsSource` 中对象的某个属性路径，直接用该属性的文本值作为显示内容。	`DisplayMemberPath="Name"`
`ItemTemplate`	[灵活方式] 指定一个 `DataTemplate`，用于完全自定义每一项的视觉外观。可包含图片、多行文本等复杂布局。	`<ListBox.ItemTemplate><DataTemplate>...</DataTemplate></ListBox.ItemTemplate>`
`ItemTemplateSelector`	指定一个数据模板选择器，用于根据数据项的逻辑动态应用不同的 `DataTemplate` (例如，及格和不及格的学生用不同模板)。	`ItemTemplateSelector="{StaticResource StudentTemplateSelector}"`
`ItemContainerStyle`	[样式核心] 设置或获取应用到每个项的容器 (即 `ListBoxItem`) 的 `Style`。可以控制选中、悬浮、禁用等状态下的外观。	用来覆写 `ListBoxItem` 的默认选中色、边距、触发器等。
`ItemContainerStyleSelector`	动态地为不同的 `ListBoxItem` 容器应用不同的样式。	不如 `ItemTemplateSelector` 常用，但可用于更深层次的样式区分。
`ItemsPanel`	指定用于布局各项的面板。默认是 `VirtualizingStackPanel`。可以换成 `WrapPanel` 实现流式布局。	`<ListBox.ItemsPanel><ItemsPanelTemplate><WrapPanel/></ItemsPanelTemplate></ListBox.ItemsPanel>`

3. 选择相关属性

用于控制和获取用户的选择行为。

属性名 (Property)	描述	常用用法 / 示例
`SelectionMode`	[模式切换] 设置列表的选择模式。<br>• `Single` : 只能单选（默认）。<br>• `Multiple` : 可点击多选。<br>• `Extended` : 可用 `Ctrl`/`Shift` 键进行多选。	`SelectionMode="Extended"`
`SelectedItems`	[多选核心] 获取一个包含所有被选中数据项的只读集合。这是处理多选结果的首选方式。	`foreach (Student s in myListBox.SelectedItems)`
`SelectedItem`	获取或设置被选中的数据对象。在多选模式下，通常返回第一个被选中的项。	`SelectedItem="{Binding CurrentStudent}"`
`SelectedIndex`	获取或设置被选中项的索引 (整数)。在多选模式下，返回有焦点的选中项的索引。	`SelectedIndex = -1;` (清空选择)
`SelectedValue`	获取或设置由 `SelectedValuePath` 指定的选中项的特定属性值。	`var score = (int)myListBox.SelectedValue;`
`SelectedValuePath`	与 `SelectedValue` 配套使用，指定要从 `SelectedItem` 中提取哪个属性的值。	`SelectedValuePath="Score"` (获取选中学生的 Score)

4. 行为与外观属性

控制 ListBox 本身的通用行为和视觉表现。

属性名 (Property)	描述	常用用法 / 示例
`ScrollViewer.HorizontalScrollBarVisibility`	(附加属性) 控制水平滚动条的可见性策略 (`Auto`, `Visible`, `Hidden`, `Disabled`)。	`ScrollViewer.HorizontalScrollBarVisibility="Auto"`
`ScrollViewer.VerticalScrollBarVisibility`	(附加属性) 控制垂直滚动条的可见性策略。	`ScrollViewer.VerticalScrollBarVisibility="Auto"`
`BorderBrush`, `BorderThickness`	设置 `ListBox` 控件自身的边框颜色和粗细。	`BorderBrush="Gray" BorderThickness="1"`
`HorizontalContentAlignment`	控制每个 `ListBoxItem` 内部内容的水平对齐。设为 `Stretch` 可让内容填满项的宽度。	`HorizontalContentAlignment="Stretch"`
`IsEnabled`, `Width`, `Height`, `Margin`等	标准的 `FrameworkElement` 属性，用于控制控件的可用状态、尺寸、位置等。	`IsEnabled="{Binding IsListEnabled}"`

5. 常用事件

事件名 (Event)	描述	何时使用
`SelectionChanged`	[最重要事件] 当用户选择发生改变时（增、删、换）触发。	在 Code-behind 中响应用户选择，执行相应逻辑。
`MouseDoubleClick`	当用户在 `ListBox` 上双击时触发。常用于实现“双击打开”功能。	在 `ListBoxItem` 上监听此事件，获取双击项并执行操作。
`ScrollChanged`	(来自 `ScrollViewer`) 当滚动位置发生变化时触发。	需要监听用户的滚动行为时使用。

十四、列表视图控件ListView与数据模板

ListView类可以使用ListBox的所有功能

示例

<ListView ItemsSource="{Binding StudentList}">
    <!-- 核心：指定使用 GridView -->
    <ListView.View>
        <GridView>
            <!-- 定义第一列：姓名 -->
            <GridViewColumn Header="姓名" 
                            Width="120" 
                            DisplayMemberBinding="{Binding Name}" />
            <!-- 定义第二列：分数，并使用模板自定义单元格 -->
            <GridViewColumn Header="分数" Width="80">
                <GridViewColumn.CellTemplate>
                    <DataTemplate>
                        <TextBlock Text="{Binding Score}" 
                                   Foreground="Red" 
                                   FontWeight="Bold" 
                                   HorizontalAlignment="Center"/>
                    </DataTemplate>
                </GridViewColumn.CellTemplate>
            </GridViewColumn>

        </GridView>
    </ListView.View>
</ListView>

1. `GridView` 本身的属性

这些属性作用于整个表格视图，控制着所有列的宏观行为。

属性名	描述	常用用法
`Columns`	核心属性。这是一个集合，包含了所有要显示的 `GridViewColumn` 对象。你大部分工作就是在这个集合里添加和配置列。	`<GridView><GridView.Columns>...</GridView.Columns></GridView>`
`AllowsColumnReorder`	一个布尔值，决定用户是否可以通过拖拽列表头来重新排列列的顺序。默认为 `true`。	`AllowsColumnReorder="False"` (如果你想锁定列的顺序)
`ColumnHeaderContainerStyle`	设置一个 `Style`，该样式将应用于所有的列标题 (`GridViewColumnHeader`)。用于统一修改所有表头的字体、背景、边框等。	设置一个带触发器的样式，实现鼠标悬浮时表头变色。
`ColumnHeaderTemplate`	设置一个 `DataTemplate`，用于自定义所有列标题的内容。比如在所有标题文字前加一个统一的图标。	`...<DataTemplate><StackPanel>...</StackPanel></DataTemplate>...`
`ColumnHeaderToolTip`	为所有的列标题设置一个统一的工具提示。	`ColumnHeaderToolTip="点击表头可排序"`

2. `GridViewColumn` 的常用属性

分类	属性名	描述	常用用法 / 示例
标题相关	`Header`	设置列标题上显示的文本内容。	`Header="学生姓名"`
	`HeaderTemplate`	为单个列标题指定一个 `DataTemplate`，用于自定义其复杂内容（如图标+文字）。	`<GridViewColumn.HeaderTemplate>...`
	`HeaderContainerStyle`	为单个列标题应用一个特定的 `Style`。	优先级高于 `GridView.ColumnHeaderContainerStyle`。
内容显示	`DisplayMemberBinding`	[快捷方式] 将单元格的内容直接绑定到数据对象的某个属性上。只适用于显示简单的文本。	`DisplayMemberBinding="{Binding Name}"`
(最重要)	`CellTemplate`	[灵活方式] 提供一个 `DataTemplate` 来完全自定义单元格的显示方式。当需要显示颜色、图标、进度条或进行复杂布局时使用。<br>注意：`DisplayMemberBinding` 和 `CellTemplate` 通常只用其一。	`<GridViewColumn.CellTemplate><DataTemplate>...</DataTemplate>`
宽度控制	`Width`	设置列的宽度。<br>• 固定值: `Width="120"`<br>• 自动: `Width="Auto"` (根据内容自动调整宽度)	`Width="100"`
	`MinWidth` / `MaxWidth`	设置列的最小/最大宽度，限制用户拖拽调整的范围。	`MinWidth="50"`，`MaxWidth="300"`