Power Apps 中的附件控制項
此控制項可讓使用者將檔案下載至其裝置,以及從使用 Microsoft Lists 或 Microsoft Dataverse 資料表建立的清單上傳及刪除檔案。
名稱
附件控制項可讓您在清單或 Dataverse 資料表中開啟、新增及刪除檔案。
限制
附件控制項有下列限制:
附件控制項只支援清單和 Dataverse 資料表作為資料來源。 不支援將這些資料來源轉換為表格的運算式,例如使用 ForAll 函數。
僅在表單中使用上傳與刪除功能。 當在編輯模式下且不在表單內時,附件控制項會看似已停用。 若要儲存檔案的新增和刪除,應用程式使用者必須儲存表單。 由於此限制緣故,無法從 Insert 索引標籤取得附件控制項但是在 SharePoint 或 Dataverse 表單中啟用附件表單欄位時,會顯示在表單中。
網頁瀏覽器上的附件控制項可讓您選取多個檔案,並允許使用拖放功能。 但是,當您在 Power Apps Mobile 上使用附件控制項時,一次只能新增一個檔案。
索引鍵屬性
Items – 清單或 Dataverse 資料表的附件資料行。 不支援集合和表格。
MaxAttachments – 控制項將會接受的檔案數目上限。
MaxAttachmentSize - 每個新附件可用的檔案大小上限 (MB)。 1 MB 在此為 1,000,000 位元組 (106 B) 或 1,000 KB。
OnAddFile – 當使用者新增檔案附件時,要執行的動作。
OnRemoveFile – 當使用者刪除現有附件時,要執行的動作。
OnUndoRemoveFile – 當使用者復原刪除附件時,要執行的動作。
其他屬性
AccessibleLabel – 螢幕報讀軟體的標籤。 應描述附件的目的。
AddAttachmentText – 連結用於新增附件的標籤文字。
BorderColor – 控制項框線的色彩。
BorderStyle – 決定控制項的框線為實線、虛線、點線或無。
BorderThickness – 控制項框線的粗細。
Color – 控制項文字的色彩。
DisabledBorderColor – 如果控制項的 DisplayMode 屬性設定為 Disabled,該控制項框線的色彩。
DisabledColor – 如果 DisplayMode 屬性設定為 Disabled,該控制項文字的色彩。
DisabledFill – 若其 DisplayMode 屬性設定為 Disabled,該控制項背景的色彩。
DisplayMode - 控制項是否允許新增及刪除檔案 (Edit)、僅顯示資料 (View),或是已停用 (Disabled)。
[DropTargetBackgroundColor]–控制項放置目標背景的色彩。
[DropTargetBorderColor]–控制項放置目標邊界的色彩。
[DropTargetBorderStyle] – 卸除目標的框線是實心線、虛線、點線或無。
[DropTargetBorderThickness]–控制項放置目標標界的厚度。
[DropTargetTextColor]–控制項放置目標文字的色彩。
Fill – 控制項背景的色彩。
FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。
FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。
Height – 控制項的頂端和底部邊緣之間的距離。
Font – 文字可使用的字型家族名稱。
FontWeight – 控制項的文字字型粗細︰粗體、半粗體、正常,或較細。
HoverBorderColor – 使用者將滑鼠游標停留在控制項上時,該控制項框線所呈現的色彩。
HoverColor – 使用者將滑鼠游標停留在控制項上時,該控制項文字所呈現的色彩。
HoverFill – 使用者將滑鼠游標停留在控制項上時,該控制項背景所呈現的色彩。
Italic – 控制項中的文字是否為斜體。
MaxAttachmentsText - 當控制項包含允許的檔案數上限時,用於取代「附件檔案」連結的文字。
NoAttachmentsText當未附加任何檔案時,向使用者顯示的資訊文字。
Padding – 匯入或匯出按鈕上的文字與該按鈕邊緣之間的距離。
PressedBorderColor – 使用者選取控制項時,該控制項框線所呈現的色彩。
PressedColor – 使用者選取控制項時,該控制項文字所呈現的色彩。
PressedFill – 使用者選取控制項時,該控制項背景所呈現的色彩。
Reset – 將附件控制項的所有變更還原到先前儲存的狀態。
Size – 控制項上文字的字型大小。
Strikethrough – 決定控制項上的文字中間是否有一條線。
TabIndex – 相對於其他控制項的鍵盤導覽順序。
Tooltip – 使用者將滑鼠停留在控制項上時所顯示的說明文字。
Underline – 決定控制項上的文字底部是否有一條線。
Visible – 控制項為可見或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
X – 控制項左邊緣與其父代容器 (或者沒有父代容器時則為畫面控制項)左邊緣之間的距離。
Y – 控制項頂部邊緣與其父代容器 (或者沒有父代容器時則為畫面控制項) 頂部邊緣之間的距離。
範例
新增表單到您的應用程式,並將清單設定為其資料來源。
選取左側樹狀檢視中的顯示表單控制項。 您也可以改用編輯表單。
選取右側選項面板的 [屬性] 索引標籤中的資料來源,然後選取您連線的清單。
在 Field 分區中選取 Edit fields,然後選取 Add field。
選取附件欄位和新增。
與清單相關聯的附件欄位會出現在表單中。
協助工具指南
色彩對比
以下項目之間必須有足夠的色彩對比:
- 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 以達成此清晰度。