SimpleListBox 和 SimpleListBoxItem

此页仅适用于 WPF 项目

列表框是一种采用可滚动列表形式的项目控件。在 Microsoft Expression Blend 中,可以通过双击列表框并在其中绘制对象(例如矩形),从而在列表框中放入内容。或者,可以在“对象和时间线”面板中右键单击列表框,然后单击“添加 SimpleListBoxItem”以向集合中添加单个项目,或者单击“将 ItemsSource 绑定到数据”以从数据源生成 SimpleListBoxItem 对象的集合。如果向集合中添加单个项目,可以双击列表框将其激活,再拖动各个项目将其改为所需顺序,来重排项目。可以使用列表框的 SelectedIndex 属性设置选定了哪一项。

添加两个项目之后的 SimpleListBox 控件的美工板视图

Cc295293.542edff2-bb86-4d80-902d-93810083b1a9(zh-cn,Expression.40).png

控件模板的分类详解

SimpleListBox 控件模板由下列项组成:

  • Grid 面板 :用于在列表框中存放多个子对象。同时,使用 Grid 也是为了便于应用程序用户界面 (UI) 的设计人员向模板添加更多对象。

  • Border 元素 :使用该元素是因为它包含 BorderThickness 属性,该属性可以用模板绑定到应用此模板的列表框控件的 BorderThickness 属性。

  • ScrollViewer 元素 :用于使应用程序的用户能够在列表过长时滚动列表。

  • StackPanel :此元素包含在 ScrollViewer 对象内,用于排列项目。 StackPanelIsItemsHost 属性设置为 True ,以便将 ScrollViewer 标识为以下对象:可显示已应用此模板的列表框控件的项目。通过在“对象和时间线”面板中右键单击 StackPanel 对象,然后为“更改布局类型”选择不同的面板(例如 UniformGrid ),可以将 StackPanel 更改为其他面板对象。

SimpleListBoxItem 控件模板由下列项组成:

  • Grid 面板 :用于在列表框项中存放多个子对象。同时,使用 Grid 也是为了便于设计人员向模板中添加更多对象。

  • Border 元素 :使用该元素是因为它包含 BorderThickness 属性,该属性可以用模板绑定到应用此模板的按钮控件的 BorderThickness 属性。

  • ContentPresenter 元素 :此元素包含在 Grid 对象中,并且自动绑定到应用此模板的项目控件的 Content 属性。

使用的属性触发器

控件模板中的属性触发器可用于使控件响应属性改变。可以在“触发器”面板中单击各项,以查看在触发器处于活动状态时更改的属性。例如,在列表框的模板中,当列表框项的 IsSelected 属性为 True 时,将改变该项的背景颜色。在列表框项的模板中,当 IsHighlighted 属性为 True 时,将改变 Border 对象的 Background 属性,以指示选定了列表框中的哪一项。

使用的画笔

SimpleListBoxSimpleListBoxItem 模板使用 SimpleStyles.xaml 资源字典中的下列画笔资源:

  • 使用下列画笔资源设置 Background 属性:在未激活任何触发器时使用 WindowBackgroundBrush ;以及在 IsEnabledFalse 时使用 DisabledBackgroundBrush

  • 使用下列画笔资源设置 BorderBrush 属性:在未激活任何触发器时使用 SolidBorderBrush ;以及在 IsEnabledFalse 时使用 DisabledBorderBrush

  • 如果 SimpleListBox 中已填充使用 SimpleListBoxItem 模板的项目,则在选定某个项目时使用 SelectedBackgroundBrush 设置该项目的 Background 属性;并在 IsEnabledFalse 时,使用 DisabledForegroundBrush 设置 Foreground 属性。

另请参阅

任务

动手试验:更改 SimpleListBox 中选定项的外观

Microsoft Corporation 版权所有 ⓒ 2011。保留所有权利。