Power Apps 中的 附件 控件

  • 项目

一个控件，允许用户将文件下载到他们的设备，以及从使用 Microsoft Lists 创建的列表或 Microsoft Dataverse 表上传和删除文件。

说明

使用 附件 控件，可从列表和 Dataverse 表打开、添加和删除文件。

限制

Attachment 控件具有以下限制：

  1. Attachment 控件仅支持列表和 Dataverse 表作为数据源。 不支持将这些数据源转换为表的表达式，例如使用 ForAll 函数。

  2. 上传和删除功能仅在窗体内部有效。 在编辑模式下，如果不在窗体内部，附件 控件会显示禁用。 若要保存文件的添加和删除，应用用户必须保存窗体。 由于此限制，附件 控件在插入选项卡中不可用，但在 SharePoint 或 Dataverse 窗体中启用了附件窗体字段时，会显示在该窗体中。

  3. Web 浏览器上的 附件 控件允许您选择多个文件，并允许使用拖放功能。 但是，在 Power Apps Mobile 上使用 附件 控件时，一次只能添加一个文件。

键属性

Items – 列表或 Dataverse 表的 Attachment 列。 不支持集合和表。

MaxAttachments – 控件将接受的文件数上限。

MaxAttachmentSize - 每个新附件的文件大小上限（以 MB 为单位）。 1 MB 在这里是 1,000,000 字节 (106 B) 或 1,000 KB。

OnAddFile - 用户添加新文件附件时要执行的操作。

OnRemoveFile – 用户删除现有附件时要执行的操作。

OnUndoRemoveFile – 当用户恢复已删除的附件时要执行的操作。

其他属性

AccessibleLabel – 屏幕阅读器标签。 应描述附件的用途。

AddAttachmentText - 用于添加新附件的链接的标签文本。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。

BorderThickness – 控件边框的粗细。

Color – 控件文本的颜色。

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

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

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

DisplayMode – 控件是允许添加和删除文件（编辑）、仅显示数据（查看），还是已禁用（禁用）。

[DropTargetBackgroundColor] – 控件拖放目标背景的颜色。

[DropTargetBorderColor] – 控件拖放目标边框的颜色。

[DropTargetBorderStyle] – 控件的拖放目标边框是实线、虚线、点线还是无。

[DropTargetBorderThickness] – 控件拖放目标边框的粗细。

[DropTargetTextColor] – 控件拖放目标文本的颜色。

Fill – 控件的背景色。

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

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

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

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

FontWeight – 控件中文本的粗细：Bold、Semibold、Normal 或 Lighter。

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

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

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

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

MaxAttachmentsText – 当控件中的文件数达到上限时，用于替换“附加文件”链接的文本。

NoAttachmentsText – 在未附加任何文件时向用户显示的说明文本。

Padding – 导入或导出按钮上的文本和该按钮边缘之间的距离。

PressedBorderColor – 用户选择控件时，该控件边框的颜色。

PressedColor – 用户选择控件时，该控件中文本的颜色。

PressedFill – 用户选择控件时，该控件的背景色。

Reset – 将对 附件 控件的所有更改还原回之前保存的状态。

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

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

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

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

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

Visible – 控件可见还是隐藏。

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

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

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

示例

  1. 在您的应用中添加一个窗体，并设置列表作为其数据源。

  2. 在左侧树视图中选择 显示窗体 控件。 您也可以改用编辑窗体。

  3. 在右侧选项面板的“属性”选项卡中选择 Data Source，然后选择您连接到的列表。

  4. 在字段部分选择编辑字段，然后选择添加字段。

  5. 选择附件字段，然后选择添加。

    与列表相关联的“附件”字段将显示在窗体中。

了解如何添加和配置控件

辅助功能准则

颜色对比度

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

  • ItemColor 和 ItemFill
  • ItemHoverColor 和 ItemHoverFill
  • ItemPressedColor 和 ItemPressedFill
  • AddedItemColor 和 AddedItemFill
  • RemovedItemColor 和 RemovedItemFill
  • ItemErrorColor 和 ItemErrorFill
  • AddAttachmentColor 和 Fill
  • MaxAttachmentsColor 和 Fill
  • NoAttachmentsColor 和 Fill

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

屏幕阅读器支持

必须存在以下属性：

键盘支持

备注

您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）

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