Поделиться через

Элемент управления Вложения в Power Apps

  • Статья

Элемент управления, который позволяет пользователям загружать файлы на свое устройство, а также загружать и удалять файлы из списка, созданного с помощью Microsoft Lists, или таблицы Microsoft Dataverse.

Описание

Элемент управления Вложения позволяет открывать, добавлять и удалять файлы из списка или таблицы Dataverse.

Ограничения

Элемент управления Attachment имеет следующие ограничения:

  1. Элемент управления attachment поддерживает только списки и таблицы Dataverse как источники данных. Выражения, которые преобразуют эти источники данных в таблицы, например с помощью функции ForAll, не поддерживаются.

  2. Функции передачи и удаления поддерживаются только внутри формы. Элемент управления Attachment будет недоступным в режиме редактирования и не в форме. Чтобы сохранить добавления и удаления файлов, пользователь приложения должен сохранить форму. Из-за этого ограничения элемент управления Attachment недоступен из вкладки Вставка, но появляется в форме, когда поле формы "Вложение" включено в форме SharePoint или Dataverse.

  3. Элемент управления Вложения в веб-браузере позволяет выбирать несколько файлов и позволяет использовать функцию перетаскивания. Однако при использовании управления вложениями в Power Apps Mobile вы можете добавлять файлы только по одному.

Ключевые свойства

Элементы — столбец Вложение в списке или в таблице Dataverse. Коллекции и Таблицы не поддерживаются.

MaxAttachments — максимальное число файлов, которое будет принимать элемент управления.

MaxAttachmentSize — максимально допустимый размер файла (в МБ) каждого нового вложения. 1 МБ здесь составляет 1 000 000 байт (106 Б) или 1000 КБ.

OnAddFile — действия, выполняемые, когда пользователь добавляет новое вложение файла.

OnRemoveFile — действия, выполняемые, когда пользователь удаляет существующее вложение.

OnUndoRemoveFile — действия, выполняемые, когда пользователь восстанавливает удаленное вложение.

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

AccessibleLabel — метка для средств чтения с экрана. Необходимо описать назначение вложений.

AddAttachmentText — текст метки для ссылки, с помощью которой добавляется новое вложение.

BorderColor  — цвет границы элемента управления.

BorderStyle  — стиль границы элемента управления: Solid, Dashed, Dotted или None.

BorderThickness  — толщина границы элемента управления.

Color  — цвет текста в элементе управления.

DisabledBorderColor — цвет границы элемента управления, если для его свойства DisplayMode установлено значение Disabled.

DisabledColor — цвет текста в элементе управления, если для его свойства DisplayMode установлено значение Disabled.

DisabledFill — цвет фона элемента управления, если для его свойства DisplayMode установлено значение Disabled.

DisplayMode — в зависимости от значения этого режима элемент управления разрешает пользователю добавлять и редактировать файлы (Edit) или только отображать данные (View), либо элемент будет вообще отключен (Disabled).

[DropTargetBackgroundColor]  — цвет фона цели перетаскивания в элементе управления.

[DropTargetBorderColor]  — цвет границы цели перетаскивания в элементе управления.

[DropTargetBorderStyle]  — тип границы цели перетаскивания элемента управления: Solid (Сплошная), Dashed (Штриховая), Dotted (Пунктирная) или None (Отсутствует).

[DropTargetBorderThickness]  — толщина границы цели перетаскивания в элементе управления.

[DropTargetTextColor]  — цвет текста цели перетаскивания в элементе управления.

Fill  — цвет фона элемента управления.

FocusedBorderColor — цвет границы элемента управления в тот момент, когда он активен.

FocusedBorderThickness — толщина границы элемента управления при наведении фокуса.

Height  — расстояние между верхним и нижним краями элемента управления.

Font  — имя семейства шрифтов, используемых для отображения текста.

FontWeight  — толщина текста в элементе управления: Bold (Жирный), Semibold (Полужирный), Normal (Обычный) или Lighter (Очень тонкий).

HoverBorderColor  — цвет границы элемента управления при наведении на него указателя мыши.

HoverColor  — цвет текста в элементе управления при наведении на него указателя мыши.

HoverFill — цвет фона элемента управления при наведении на него указателя мыши.

Italic  — определяет, отображается ли текст в элементе управления курсивом.

MaxAttachmentsText — текст, который заменяет ссылку "Присоединить файл", когда элемент управления содержит максимальное допустимое число файлов.

NoAttachmentsText — информационный текст, который видит пользователь, когда нет файлов для отображения.

Padding  — расстояние между текстом кнопки "Импорт" или "Экспорт" и границами кнопки.

PressedBorderColor  — цвет границы элемента управления, когда пользователь выбирает этот элемент управления.

PressedColor  — цвет текста в элементе управления, когда пользователь выбирает этот элемент управления.

PressedFill  — цвет фона элемента управления, когда пользователь выбирает этот элемент управления.

Reset — отменяет все изменения элемента управления Вложения, возвращая к ранее сохраненному состоянию.

Size  — размер шрифта текста, отображаемого в элементе управления.

Strikethrough — определяет, должна ли через текст, отображаемый в элементе управления, проходить линия.

TabIndex — порядок навигации с помощью клавиатуры относительно других элементов управления.

Tooltip  — пояснительный текст, отображаемый при наведении указателя мыши на элемент управления.

Underline — определяет, должна ли под текстом, отображаемым в элементе управления, проходить линия.

Visible — отображение или скрытие элемента управления.

Width  — расстояние между левым и правым краями элемента управления.

X  — расстояние между левым краем элемента управления и левым краем его родительского контейнера (или экрана, если родительского контейнера нет).

Y  — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера (или экрана, если родительского контейнера нет).

Пример

  1. Добавьте форму в приложение и укажите в качестве источника данных список.

  2. Выберите элемент управления Форма отображения в представлении в виде дерева слева. Вместо этого можно также использовать элемент управления Edit form.

  3. Выберите Источник данных на вкладке "Свойства" на панели параметров справа, затем выберите список, к которому вы подключены.

  4. Выберите Редактировать поля в разделе Поля и выберите Добавить поле.

  5. Выберите поле Вложения и выберите Добавить.

    Поле "Вложения", связанное со списком, отобразится в форме.

Узнайте, как добавить и настроить элемент управления

Руководство по настройке специальных возможностей

Контрастность цветов

Необходимо настроить достаточный контраст для следующих элементов:

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

Это требование дополняет стандартные требования по цветовому контрасту.

Поддержка средства чтения с экрана

Должны присутствовать следующие свойства:

Поддержка клавиатуры

  • Значение элемента TabIndex должно быть равно нулю или больше нуля, чтобы пользователи могли использовать навигацию с помощью клавиатуры.
  • Индикаторы фокуса должны быть хорошо видны. Для такой хорошей видимости используются элементы FocusedBorderColor и FocusedBorderThickness.

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).