Power Apps 中的数据表控件

以表格格式显示一组数据。

Description

数据表控件以格式显示数据集，该数据集包含控件显示的每个字段的列标题。 作为应用创建者，你可以完全控制显示哪些字段以及按何种顺序显示。 与 库 控件一样， 数据表 控件维护指向所选行的 Selected 属性。 因此，可以将 数据表 控件链接到其他控件。

局限性

数据表控件具有以下限制：

• 如果复制并粘贴一个 Data Table 控件，其中 Items 属性设置为包含 Filter 函数的公式，则新数据表控件上的 Items 属性的公式最终包含包含 _1 后缀的字段名称。 这使得字段名称无效，并且不会显示任何数据显示在数据表中。 若要解决此问题，在复制控件之前，请确认 Filter 函数不会引用数据源中与 数据表 控件中的列同名的任何字段。 如果这样做，请重命名 数据表 控件中的列。 或者，从无效的字段名称中删除 _1 后缀，使其与表中的名称匹配。

Capabilities

Power Apps 于 2017 年 5 月 5 日引入了 数据表 控件。 本部分提供有关支持的功能以及不支持的功能的信息。

现已推出

• 数据表控件中的数据是只读的。
• 数据表 控件中 始终选择单个行。
• 将 数据表 控件链接到连接的或本地数据源。
• 在运行应用时调整 数据表 控件中的列宽，但不会保存更改。
• 将一组默认字段链接到已实现此功能的连接器（如 Microsoft Dataverse）时，该字段将显示在 数据表 控件中。 然后，可以根据需要显示或隐藏这些字段和其他字段。
• 自定义列宽和标题文本。
• 在 数据表 控件中显示超链接。
• 复制并粘贴 数据表 控件。

尚未发布

• 自定义各个列的样式。
• 在窗体控件中添加 数据表 控件。
• 更改所有行的高度。
• 在 数据表 控件中显示图像。
• 显示相关表中的字段。
• 使用内置功能按列标题筛选和排序数据。
• 在库控件中添加数据表控件。
• 编辑 数据表 控件中的数据。
• 选择多行。

已知问题

• 如果在 Items 属性中使用 FirstN 函数，则不会显示任何数据。

键属性

• 项 – 显示在 数据表 控件中的数据源。
• 已选择 – 数据表 控件中的选定行。

其他属性

• AutoWidth - 数据表中列的属性，用于定义列宽是自动还是手动。
• BorderColor – 数据表 控件边框的颜色。
• BorderStyle – 数据表 控件边框的样式。 选项为 Solid、 Dashed、 Dotted 和 None。
• BorderThickness – 数据表 控件边框的粗细。
• 颜色 – 所有数据行的默认文本颜色。
• FieldDisplayName - 数据表中定义所选列的显示名称的列的属性。
• 填充 – 所有数据行的默认背景色。
• 字体 - 所有数据行的默认字体。
• FontWeight – 所有数据行的默认字体粗细。
• HeadingColor – 列标题的文本颜色。
• HeadingFill – 列标题的背景色。
• HeadingFont – 列标题的字体。
• HeadingFontWeight – 列标题的字体粗细。
• HeadingSize – 列标题的字号。
• 高度 – 数据表 控件的上边缘和下边缘之间的距离。
• HoverColor – 鼠标指针指向的行的文本颜色。
• HoverFill – 鼠标指针指向的行的背景色。
• IsHyperlink - 数据表中某个列的属性，用于定义所选列是否应采用超链接格式。
• NoDataText – 当用户在 数据表 控件中没有要显示的记录时接收的消息。
• Order - 数据表中列的属性，用于确定列与其他列各自的顺序。 顺序从左到右开始，第一列顺序值为 1。
• SelectedColor – 所选行中文本的颜色。
• SelectedFill – 所选行的背景色。
• 大小 – 所有数据行的默认字号。
• Text - 数据表中列的属性，用于定义要在所选列内显示的数据的文本值。
• 可见 – 一个值，该值确定 数据表 控件是显示还是隐藏。
• 宽度 – 数据表 控件的左边缘和右边缘之间的距离。
• X – 数据表 控件的左边缘与其父容器的左边缘之间的距离（如果没有父容器，则为屏幕的左边缘）。
• Y – 数据表 控件的上边缘与其父容器的上边缘之间的距离（如果没有父容器，则为屏幕的上边缘）。

相关函数

• Filter（DataSource， Formula）（DataSource， Formula）
• Search（DataSource、SearchString、Column）（DataSource、 SearchString、 Column）

例子

基本用法

1. 创建空白平板电脑应用。

2. 在 “插入 ”选项卡上，单击或点击 “数据表”。

   

   数据表控件将添加到屏幕。

3. 重命名 数据表 控件 SalesOrderTable，并调整其大小，使其覆盖整个屏幕。

4. 在右窗格中，选择 “数据源”，然后选择“ 销售订单”。 如果未列出该表，请搜索该表，然后连接到 Microsoft Dataverse。

   

   数据表控件现在附加到销售订单数据源。 数据表控件中会显示几个初始字段，因为我们使用的是支持该功能的连接器。

   

5. 在右窗格中，选中一个或多个复选框以显示或隐藏单个字段。

   例如，选中 CustomerPurchaseOrderReference 旁边的复选框可隐藏此字段。

6. 在右窗格中，通过向上或向下拖动字段对字段重新排序。

   

   SalesOrderTable 控件按指定的顺序显示字段。

   

Restyle Data table 控件的标头

1. 选择 “数据表 ”控件时，在右窗格中，单击或点击“ 高级 ”选项卡。

2. 单击或点击 HeadingFill 属性的字段，然后将值更改为 RGBA（62,96,170,1）。

3. 单击或点击 HeadingColor 属性的字段，然后将值更改为 White。

4. 单击或点击 HeadingSize 属性的字段，然后将值更改为 14。

   

将数据表控件连接到另一个控件

1. 向屏幕添加 “编辑”窗体 控件。

2. 调整 数据表 和 编辑窗体 控件的大小，使 数据表 控件显示在屏幕左侧，编辑 窗体 控件显示在屏幕右侧。

   

3. 选择 Form1 时，在右窗格中，将列数更改为 1。

4. 将 Form1 连接到 销售订单 数据源。

   Form1 中显示多个初始字段。

   

5. 在右窗格中，单击或点击“ 高级 ”选项卡。

6. 将 Form1 的 Item 属性设置为 SalesOrderTable.Selected。

   Form1 显示 数据表 控件中选择的行中的信息。

   

辅助功能指南

颜色对比度

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

• 颜色 和 填充
• HeadingColor 和 HeadingFill
• SelectedColor 和 SelectedFill
• HoverColor 和 HoverFill

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

屏幕阅读器支持

• NoDataText 必须存在。