一个控件,允许用户将文件下载到其设备,以及从使用Microsoft列表或 Microsoft Dataverse 表创建的列表中上传和删除文件。
Description
使用附件控件,可以从列表或 Dataverse 表打开、添加和删除文件。
局限性
附件控件具有以下限制:
附件控件仅支持作为数据源的列表和 Dataverse 表。 不支持将这些数据源转换为表的表达式,例如使用 ForAll 函数。
上传和删除功能仅在窗体内工作。 当处于“编辑”模式而不是窗体内部时,“附件”控件将处于禁用状态。 若要保存文件添加和删除,应用用户必须保存表单。 由于此限制,附件控件在 “插入 ”选项卡中不可用,但在 SharePoint 或 Dataverse 窗体中启用“附件”窗体字段时显示在窗体中。
使用 Web 浏览器上的附件控件可以选择多个文件,并允许使用拖放功能。 但是,在 Power Apps Mobile 上使用附件控件时,一次只能添加一个文件。
存储在 OneDrive 或任何其他云存储中的文件可能无法正确附加。 在使用设备的文件选取器附加这些文件之前,请尝试将这些文件下载到设备。
键属性
项目 – 列表或 Dataverse 表的 “附件 ”列。 不支持集合 和 表 。
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 – 控件边框的粗细。
颜色 – 控件文本的颜色。
DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled,则控件边框的颜色。
DisabledColor – 控件中的文本颜色(如果控件的 DisplayMode 属性设置为 Disabled)。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。
DisplayMode – 控件是否允许添加和删除文件(编辑),仅显示数据(视图),还是被禁用(已禁用)。
[DropTargetBackgroundColor] – 控件的放置目标背景的颜色。
[DropTargetBorderColor] – 控件的放置目标边框的颜色。
[DropTargetBorderStyle] – 控件的放置目标边框是 Solid、 Dashed、 Dotted 还是 None。
[DropTargetBorderThickness] – 控件的放置目标边框的粗细。
[DropTargetTextColor] – 控件的放置目标文本的颜色。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
高度 – 控件的上边缘和下边缘之间的距离。
字体 – 显示文本的字体系列的名称。
FontWeight – 控件中文本的粗细: 粗体、 半曲、 普通或 较轻。
HoverBorderColor – 当用户在该控件上保留鼠标指针时控件边框的颜色。
HoverColor – 当用户将鼠标指针放在控件上时,控件中文本的颜色。
HoverFill – 当用户将鼠标指针放在控件上时,控件的背景色。
斜体 – 控件中的文本是否为斜体。
MaxAttachmentsText – 当控件包含允许的最大文件数时替换“附加文件”链接的文本。
NoAttachmentsText – 没有附加文件时向用户显示的信息性文本。
填充 – 导入或导出按钮上的文本与该按钮边缘之间的距离。
PressedBorderColor – 当用户选择该控件时控件边框的颜色。
PressedColor – 当用户选择该控件时控件中的文本颜色。
PressedFill – 当用户选择该控件时控件的背景色。
重置 – 还原返回以前保存状态的附件控件的所有更改。
大小 – 控件上显示的文本的字号。
删除线 – 是否通过控件上显示的文本显示线条。
TabIndex – 相对于其他控件的键盘导航顺序。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
下划线 – 是否在控件上显示的文本下显示一行。
可见 – 控件是可见还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件的左边缘与其父容器的左边缘(或屏幕(如果没有父容器)之间的距离。
Y – 控件的上边缘与父容器的上边缘(或屏幕(如果没有父容器)之间的距离。
Example
将窗体添加到应用,并将列表设置为其数据源。
在左侧的树视图中选择 “显示窗体 ”控件。 还可以改用 “编辑表单 ”。
在右侧选项面板中的“属性”选项卡中选择 “数据源 ”,然后选择连接到的列表。
在“字段”部分选择“编辑字段”,然后选择“添加字段”。
选择 “附件 ”字段,然后选择“ 添加”。
与列表关联的附件字段将显示在窗体中。
辅助功能指南
颜色对比度
在以下两者之间必须有足够的颜色对比度:
- ItemColor 和 ItemFill
- ItemHoverColor 和 ItemHoverFill
- ItemPressedColor 和 ItemPressedFill
- AddedItemColor 和 AddedItemFill
- RemovedItemColor 和 RemovedItemFill
- ItemErrorColor 和 ItemErrorFill
- AddAttachmentColor 和 Fill
- MaxAttachmentsColor 和 Fill
- NoAttachmentsColor 和 Fill
此要求除了 标准颜色对比度要求外。
屏幕阅读器支持
必须存在以下属性:
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
键盘支持
- TabIndex 必须为零或更大,以便键盘用户可以导航到它。
- 焦点指示器必须清晰可见。 使用 FocusedBorderColor 和 FocusedBorderThickness 实现此清晰度。