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 – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

Color – 控件文本的颜色。

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

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

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

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

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

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

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

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

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

Fill – 控件的背景色。

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

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

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

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

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

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. 选择附件字段,然后选择添加

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

了解如何添加和配置控件

辅助功能准则

颜色对比度

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

  • ItemColorItemFill
  • ItemHoverColorItemHoverFill
  • ItemPressedColorItemPressedFill
  • AddedItemColorAddedItemFill
  • RemovedItemColorRemovedItemFill
  • ItemErrorColorItemErrorFill
  • AddAttachmentColorFill
  • MaxAttachmentsColorFill
  • NoAttachmentsColorFill

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

屏幕阅读器支持

必须存在以下属性:

键盘支持

备注

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

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