Power Apps 中的 List Box 控件

用户可以在其中选择一个或多个项的列表。

Description

列表框控件始终显示所有可用选项(与下拉列表控件不同),并且用户可以一次选择多个项(与单选控件不同)。

键属性

默认值 – 用户更改控件之前控件的初始值。

注释

只能有一个默认的选定项。 如果需要多个选定项,请使用 组合框 控件。

– 显示在控件(如库、列表或图表)中的数据源。

添加库、列表或图表时,属性列表默认显示 Items ,以便可以轻松指定新控件应显示的数据。 例如,可以将库的 Items 属性设置为 Salesforce 中的 Account 表、在 Excel 中创建并上传到云的 清单 表或名为 ConferenceSpeakers 的列表。

其他属性

AccessibleLabel – 屏幕阅读器标签。

BorderColor – 控件边框的颜色。

BorderStyle – 控件的边框是 SolidDashedDotted 还是 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 – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。

DistinctDataSourceColumnName

Example

  1. 添加 列表框 控件,将其命名为 CategoryList,并将其 Items 属性设置为以下公式:
    [“地毯”,“硬木”,“磁贴”]

    不知道如何添加、命名和配置控件

    列表框中的地板类别。

  2. 添加三个 下拉列表 控件,在 CategoryList 下移动它们,并将其命名为 CarpetList硬木列表TileList

  3. 将每个下拉列表控件的 Items 属性设置为以下值之一:

    • 地毯名单: [“凯塞塔石米色”,“无龄美红土”,“卢什二号通德拉”]

    • 硬木列表: [“金茶”,“自然希科里”, “维多利亚红木”]

    • TileList: [“Honey Onyx Marble”,“Indian Autumn Slate”, “Panaria Vitality Ceramic”]

      下拉列表中的地板名称。

  4. 将每个下拉列表控件的 Visible 属性设置为以下值之一:

    • CarpetList: If(CategoryList.SelectedItems.Value 中的“Carpet”,true)

    • 硬木列表: If(CategoryList.SelectedItems.Value 中的“硬木”,true)

    • TileList: If(CategoryList.SelectedItems.Value 中的“Tile”,true)

      想要详细了解 If 函数 或其他函数

  5. 按 F5,然后在 CategoryList 中选择一个或多个项目。

    相应的 下拉 控件或控件根据选择或选项显示。

    选定的列表。

  6. (可选)按 Esc 返回到默认工作区。

辅助功能指南

颜色对比度

在以下两者之间必须有足够的颜色对比度:

这除了 标准颜色对比度要求之外。

屏幕阅读器支持

键盘支持

  • TabIndex 必须为零或更大,以便键盘用户可以导航到它。

  • 焦点指示器必须清晰可见。 使用 FocusedBorderColorFocusedBorderThickness 来实现此目的。

    注释

    选项卡键导航到列表框或离开 列表框。 箭头键导航 列表框的内容。