列表框

控件 ListBox 显示用户可以从中选择的项集合。 ListBox 支持单个或多个选择,并提供键盘导航、滚动功能和数据绑定功能。 它通常用于用户需要从预定义选项中进行选择的窗体和应用程序中。

显示可选项列表的典型 ListBox 控件的屏幕截图

Title Description
将 ListBox 绑定到数据 演示如何将 ListBox 绑定到数据源。
获取 ListBoxItem 演示如何从 ListBox 中检索特定的 ListBoxItem。
提高 ListBox 的滚动性能 演示如何优化 ListBox 中包含多个项的滚动性能。

样式和模板

可以修改默认值 ControlTemplate ,使 ListBox 控件具有唯一的外观。 有关详细信息,请参阅什么是样式和模板?以及如何为控件创建模板。

在为ControlTemplate创建ListBox时,你的模板可能包含在ItemsPresenter中的ScrollViewer。 ItemsPresenter 显示 ListBox 中的每个项目,ScrollViewer 启用控件内的滚动功能。 如果ItemsPresenter不是ScrollViewer的直接子级,则必须将ItemsPresenter命名为ItemsPresenter。

Content 属性

控件 ListBox 使用属性 Items 作为其内容属性。 此属性表示 ListBox 中显示的项的集合,并支持将数据绑定到各种数据源。

部件

该 ListBox 控件不定义任何命名的模板部件。

视觉状态

下表列出了控件的 ListBox 视觉状态。

VisualState 名称 VisualStateGroup 名称 Description
无效焦点 ValidationStates 控件存在验证错误,并且具有键盘焦点。
无效未聚焦 ValidationStates 控件存在验证错误,但没有键盘焦点。
有效 ValidationStates 该控件有效且没有验证错误。

另请参阅