Контрола Прикачени файлове в Power Apps

  • Статия

Контрол, който позволява на потребителите да изтеглят файлове на своето устройство, както и да качват и изтриват файлове от списък, създаден с помощта на Microsoft Lists, или от таблица на Microsoft Dataverse.

Описание

Контрола Прикачени файлове ви позволява да отваряте, добавяте и изтривате файлове от таблица на Dataverse.

Ограничения

Контролът на прикачения файл има следните ограничения:

  1. Контролът на прикачените файлове поддържа само списъци и Dataverse таблици като източници на данни. Изрази, които трансформират тези източници на данни в таблици, например с функцията ForAll, не се поддържат.

  2. Функциите за качване и изтриване работят само във формуляр. Контролата Прикачени файлове се показва деактивирана, когато е в режим на редактиране, а не е във формуляр. За да запишете файлови добавки и изтривания, потребителят на приложението трябва да запази формуляра. Поради това ограничение контролът на прикачването не е наличен от раздела Вмъкване, но се появява във формата, когато полето за формуляр за прикачване е активирано в SharePoint или Dataverse обекти.

  3. Контролът на прикачените файлове в уеб браузър ви позволява да изберете множество файлове и позволява използването на функция за плъзгане и пускане. Въпреки това, когато използвате прикачени файлове, контролът е включен Power Apps Mobile, можете да добавяте файлове само един по един.

Свойства на ключове

Елементи – Колоната Прикачен файл на списъка или таблица на Dataverse. Колекциите и таблиците не се поддържат.

MaxAttachments - Максималният брой файлове, които контролът ще приеме.

MaxAttachmentSize - Максимално разрешеният размер на файла в MB на всеки нов прикачен файл. 1 MB тук е 1 000 000 байта (106 B) или 1000 KB.

OnAddFile – Действия, които се изпълняват, когато потребителят добави нов прикачен файл.

OnRemoveFile – Действия, които се изпълняват, когато потребителят изтрие съществуващ прикачен файл.

OnUndoRemoveFile – Действия, които се изпълняват, когато потребителят възстанови изтрит прикачен файл.

Допълнителни свойства

AccessibleLabel - Етикет за четци на екрани. Трябва да опише целта на прикачения файл.

AddAttachmentText - Текстът на етикета за връзката, използвана за добавяне на нов прикачен файл.

BorderColor – Цветът на границата на контролата.

BorderStyle – Дали границата на контрола е солидна, с тирета, с точки или няма.

BorderThickness – Дебелината на границата на контролата.

Цвят – Цветът на текста в контрола.

DisabledBorderColor - Цветът на границата на контрола, ако този на свойството DisplayMode на контролата е настроено на Забранено.

DisabledColor - Цветът на текст на контрола, ако нейното свойство DisplayMode е настроено на Забранено.

DisabledFill - Цветът на фона на контрола, ако нейното свойство DisplayMode е настроено на Забранено.

DisplayMode – Дали контрола позволява добавяне и изтриване на файлове (редактиране), показва само данни (изглед) или е деактивирана (Забранено).

[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 - Разстоянието между горния ръб на контрола и горния ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).

Пример

  1. Добавете формуляр в приложението си и задайте списък като своя източник на данни.

  2. Изберете контролата Display form в изглед на дърво отляво. Можете също да използвате Edit Form вместо това.

  3. Изберете Източник на данни в раздела Свойства в панела с опции вдясно и след това изберете списък, с който сте се свързали.

  4. Изберете Редактиране на полета в секцията Полетата и изберете Добавете поле.

  5. Изберете полето Attachments и изберете Добавяне.

    Полето прикачени файлове, свързано със списък ще се появи във формуляра.

Научете как да добавяте и конфигурирате контрола

Насоки за достъпност

Контраст на цвят

Трябва да има достатъчен цветен контраст между:

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

Това изискване е в допълнение към стандартни изисквания за цветен контраст.

Поддръжка на екранен четец

Следните свойства трябва да бъдат налични:

Поддръжка на клавиатурата

  • TabIndex трябва да е нула или повече, така че потребителите с клавиатура да могат да навигират.
  • Индикаторите за фокус трябва да са ясно видими. Използвайте FocusedBorderColor и FocusedBorderThickness за постигане на тази яснота.

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).