Power Apps 中的 列表框 控件

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

描述

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

关键属性

Default – 用户更改控件前的初始值。

备注

您只可有一个默认选定项。 如需多个选定项,请使用 组合框 控件。

Items – 控件中显示的数据源,如库、列表或图表。

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

其他属性

AccessibleLabel – 屏幕阅读器标签。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

Color – 控件中文本的颜色。

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。

DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。

DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。

DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。

Fill – 控件的背景色。

FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。

FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。

Font – 文本中所显示的字体系列的名称。

FontWeight – 控件中文本的粗细:BoldSemiboldNormalLighter

Height – 控件上边缘和下边缘之间的距离。

HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。

HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。

HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。

Italic – 控件中的文本是否为斜体。

ItemPaddingLeft – 列表框中的文本与其左边缘之间的距离。

LineHeight – 诸如文本行之间或列表中各项之间的距离。

OnChange - 用户更改控件的值(例如,通过调整滑块)时要执行的操作。

OnSelect – 当用户点击或单击控件时要执行的操作。

PaddingBottom – 控件中的文本与该控件下边缘之间的距离。

PaddingLeft – 控件中的文本与该控件左边缘之间的距离。

PaddingRight – 控件中的文本与该控件右边缘之间的距离。

PaddingTop – 控件中的文本与该控件上边缘之间的距离。

PressedBorderColor – 用户在点击或单击控件时,该控件边框的颜色。

PressedColor – 用户在点击或单击控件时,该控件中的文本的颜色。

PressedFill – 用户在点击或单击控件时,该控件的背景色。

Reset – 控件是否还原为其默认值。

Selected – 表示选定项的数据记录。

备注

您只可有一个默认选定项。 如需多个选定项,请使用 组合框 控件。

SelectedItems - 只读。 表示多选列表框中选定项的数据表。

SelectedItemsText - 只读。 表示多选列表框中选定项文本的数据表。

SelectedText (Deprecated) – 表示选定项的字符串值。

SelectionColor – 所选项目或列表中项目的文本颜色,或笔控件中选择工具的颜色。

SelectionFill – 所选项、列表中的项或笔控件中选定区域的背景色。

SelectMultiple – 用户是否可以选择列表框中的多个项目。

Size – 控件上显示的文本的字号。

Strikethrough – 通过文本显示的线是否在控件上显示。

TabIndex – 相对于其他控件的键盘导航顺序。

Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。

Underline – 在文本下方显示的线是否在控件上显示。

Visible – 控件显示还是隐藏。

Width – 控件左边缘和右边缘之间的距离。

X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。

Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。

Distinct( DataSource, ColumnName )

示例

  1. 添加 列表框 控件,将其命名为 CategoryList,并将其 Items 属性设置为以下公式:
    ["Carpet","Hardwood","Tile"]

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

    列表框中的地板类别。

  2. 添加三个 下拉 控件,将它们移动到 CategoryList 下,并分别命名为 CarpetListHardwoodListTileList

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

    • CarpetList:["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]

    • HardwoodList:["Golden Teak","Natural Hickory", "Victoria Mahogany"]

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

      下拉列表中的地板名称。

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

    • CarpetList:If("Carpet" in CategoryList.SelectedItems.Value, true)

    • HardwoodList:If("Hardwood" in CategoryList.SelectedItems.Value, true)

    • TileList:If("Tile" in CategoryList.SelectedItems.Value, true)

      想要了解有关 If 函数或其他函数的详细信息?

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

    根据您的选择,将显示相应的一个或多个 下拉 控件。

    选定的列表。

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

辅助功能准则

颜色对比度

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

这是除标准颜色对比度以外的要求。

屏幕阅读器支持

键盘支持

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

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

    备注

    Tab 键导航到列表框或离开列表框。 箭头键导航列表框中的内容。

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

此调查大约需要七分钟。 不会收集个人数据(隐私声明)。