允許使用者將檔案下載到其裝置,以及從使用 Microsoft Lists 或 Microsoft Dataverse 資料表建立的清單上傳和刪除檔案的控制項。
Description
附件控制項可讓您從清單或 Dataverse 資料表開啟、新增和刪除檔案。
局限性
附件控制項有下列限制:
附件控制項僅支援清單和 Dataverse 資料表作為資料來源。 不支援將這些資料來源轉換為資料表的運算式,例如,使用 ForAll 函式。
上傳和刪除功能僅適用於表單內。 「附件」控制項在「編輯」模式中顯示為停用,而不是在表單中。 若要儲存檔案新增和刪除,應用程式使用者必須儲存表單。 由於此限制,附件控制項無法從 插入 索引標籤中使用,但當在 SharePoint 或 Dataverse 表單中啟用附件表單欄位時,附件控制項會出現在表單中。
網頁瀏覽器上的附件控制項可讓您選取多個檔案,並允許使用拖放功能。 不過,在 Power Apps Mobile 上使用附件控制項時,您一次只能新增一個檔案。
儲存在 OneDrive 或任何其他雲端儲存中的檔案可能無法正確附加。 嘗試將這些檔案下載到裝置,然後再使用裝置的檔案選擇器附加它們。
Power Apps 行動應用程式不支援直接從相機拍攝影片,也無法在使用 附件 控制時從照片庫中選擇影片。 要新增影片,使用者必須使用 瀏覽 選項。
- 在 Android 上: 瀏覽 選項會顯示所有檔案類型,包括影片,讓你選擇並附加影片檔案。
- 在 iOS 上: 瀏覽 選項只會顯示儲存在檔案應用程式裡的檔案。 如果你的影片還沒儲存在那裡,你需要先把影片移到 Files 應用程式裡,再附上去。
如果影片沒有出現附加選項,先把影片存到裝置的檔案應用程式,再試一次。
索引鍵屬性
項目 – 清單或 Dataverse 資料表的 附件 資料行。 不支援集合和表格。
MaxAttachments – 控制項將接受的檔案數目上限。
MaxAttachmentSize — 每個新附件允許的檔案大小上限 (MB)。 這裡的 1 MB 是 1,000,000 位元組 (106 B) 或 1,000 KB。
OnAddFile – 使用者新增檔案附件時要執行的動作。
OnRemoveFile — 使用者刪除現有附件時要執行的動作。
OnUndoRemoveFile — 使用者還原已刪除附件時要執行的動作。
其他屬性
AccessibleLabel — 螢幕助讀程式的標籤。 應描述附件的用途。
AddAttachmentText — 用來新增附件之連結的標籤文字。
BorderColor – 控制項框線的色彩。
BorderStyle – 控制項的框線是 Solid、 Dashed、 Doted 還是 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
- NoAttachments顏色 和 填充
此要求是 標準色彩對比要求的補充。
支援螢幕助讀程式
必須存在下列屬性:
- 可存取標籤
- 新增附件文字
- 最大附件文字
- 無附件文字
鍵盤支援
- TabIndex 必須為零或更大,鍵盤使用者才能流覽至它。
- 焦點指示器必須清晰可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 來達到此清晰度。