用户可以在其中选择一个或多个项的列表。
Description
列表框控件始终显示所有可用选项(与下拉列表控件不同),并且用户可以一次选择多个项(与单选控件不同)。
键属性
默认值 – 用户更改控件之前控件的初始值。
注释
只能有一个默认的选定项。 如果需要多个选定项,请使用 组合框 控件。
项 – 显示在控件(如库、列表或图表)中的数据源。
添加库、列表或图表时,属性列表默认显示 Items ,以便可以轻松指定新控件应显示的数据。 例如,可以将库的 Items 属性设置为 Salesforce 中的 Account 表、在 Excel 中创建并上传到云的 清单 表或名为 ConferenceSpeakers 的列表。
其他属性
AccessibleLabel – 屏幕阅读器标签。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
颜色 – 控件中的文本颜色。
DisplayMode – 控件是否允许用户输入(编辑)、仅显示数据(视图)或已禁用(已禁用)。
DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled,则控件边框的颜色。
DisabledColor – 控件中的文本颜色(如果控件的 DisplayMode 属性设置为 Disabled)。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
字体 – 显示文本的字体系列的名称。
FontWeight – 控件中文本的粗细: 粗体、 半曲、 普通或 较轻。
高度 – 控件的上边缘和下边缘之间的距离。
HoverBorderColor – 当用户在该控件上保留鼠标指针时控件边框的颜色。
HoverColor – 当用户将鼠标指针放在控件上时,控件中文本的颜色。
HoverFill – 当用户将鼠标指针放在控件上时,控件的背景色。
斜体 – 控件中的文本是否为斜体。
ItemPaddingLeft – 列表框中的文本与其左边缘之间的距离。
LineHeight – 列表中的文本或项目行之间的距离。
OnChange – 当用户更改控件值时要执行的作(例如,通过调整滑块)。
OnSelect – 当用户点击或单击控件时要执行的作。
PaddingBottom – 控件中的文本与该控件的下边缘之间的距离。
PaddingLeft – 控件中的文本与该控件的左边缘之间的距离。
PaddingRight – 控件中的文本与该控件右边缘之间的距离。
PaddingTop – 控件中的文本与该控件的上边缘之间的距离。
PressedBorderColor – 当用户点击或单击该控件时控件边框的颜色。
PressedColor – 当用户点击或单击该控件时控件中的文本颜色。
PressedFill – 当用户点击或单击该控件时控件的背景色。
重置 – 控件是否还原为其默认值。
已选择 – 表示所选项的数据记录。
注释
只能有一个默认的选定项。 如果需要多个选定项,请使用 组合框 控件。
SelectedItems - 只读。 表示多选列表框的选定项的数据表。
SelectedItemsText - 只读。 表示多选列表框的选定项目文本的数据表。
SelectedText (已弃用) - 一个表示所选项的字符串值。
SelectionColor – 选定项或列表中的项的文本颜色,或笔控件中选定工具的颜色。
SelectionFill – 列表或笔控件的选定区域中所选项目或项的背景色。
SelectMultiple – 用户是否可以在列表框中选择多个项目。
大小 – 控件上显示的文本的字号。
删除线 – 是否通过控件上显示的文本显示线条。
TabIndex – 相对于其他控件的键盘导航顺序。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
下划线 – 是否在控件上显示的文本下显示一行。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
相关函数
Distinct( DataSource、 ColumnName )
Example
添加 列表框 控件,将其命名为 CategoryList,并将其 Items 属性设置为以下公式:
[“地毯”,“硬木”,“磁贴”]不知道如何添加、命名和配置控件?
添加三个 下拉列表 控件,在 CategoryList 下移动它们,并将其命名为 CarpetList、 硬木列表和 TileList。
-
地毯名单: [“凯塞塔石米色”,“无龄美红土”,“卢什二号通德拉”]
硬木列表: [“金茶”,“自然希科里”, “维多利亚红木”]
TileList: [“Honey Onyx Marble”,“Indian Autumn Slate”, “Panaria Vitality Ceramic”]
按 F5,然后在 CategoryList 中选择一个或多个项目。
相应的 下拉 控件或控件根据选择或选项显示。
(可选)按 Esc 返回到默认工作区。
辅助功能指南
颜色对比度
在以下两者之间必须有足够的颜色对比度:
- SelectionColor 和 SelectionFill
- SelectionFill 和 Fill
- HoverFill 和 Fill
- PressedFill 和 Fill
这除了 标准颜色对比度要求之外。
屏幕阅读器支持
- AccessibleLabel 必须存在。
键盘支持
TabIndex 必须为零或更大,以便键盘用户可以导航到它。
焦点指示器必须清晰可见。 使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。
注释
选项卡键导航到列表框或离开 列表框。 箭头键导航 列表框的内容。