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

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

Description

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

Ограничения

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

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

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

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

  4. Возможно, вы не сможете подключить файлы, хранящиеся в OneDrive или другом облачном хранилище. Попробуйте скачать эти файлы на устройство, прежде чем подключить их с помощью средства выбора файлов устройства.

  5. Мобильное приложение Power Apps не поддерживает запись видео непосредственно с камеры или выбор видео из библиотеки фотографий при использовании элемента управления "Вложения ". Чтобы добавить видео, пользователи должны использовать параметр "Обзор ".

    • В Android: параметр "Обзор " отображает все типы файлов, включая видео, чтобы можно было выбрать и подключить видеофайлы.
    • В iOS: параметр "Обзор " отображает только файлы, хранящиеся в приложении "Файлы ". Если видео еще не сохранено, перед присоединением его необходимо переместить в приложение "Файлы ".

    Если видео не отображается в качестве параметра для присоединения, сначала сохраните видео в приложении "Файлы " устройства и повторите попытку.

  6. Отправка и просмотр вложений не поддерживается при запуске приложений на основе холста в Microsoft Teams на мобильных устройствах Android или iOS.

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

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

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

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

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

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

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

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

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

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

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

BorderStyle — является ли граница элемента управления твердым, дефишированным, dotted или None.

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

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

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

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

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

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

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

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

[DropTargetBorderStyle] — является ли целевая граница элемента управления твердым, dashed, dotted или None.

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

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

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

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

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

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

Шрифт — имя семейства шрифтов, в которых отображается текст.

FontWeight — вес текста в элементе управления: полужирный, полужирный, полуболдный, обычный или легкий.

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

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

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

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

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

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

Заполнение — расстояние между текстом на кнопке импорта или экспорта и краями этой кнопки.

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

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

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

Сброс — отменяет все изменения элемента управления вложениями и возвращает ранее сохраненное состояние.

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

Зачеркнутое. Отображается ли строка с помощью текста, отображаемого на элементе управления.

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

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

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

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

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

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

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

Example

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

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

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

  4. Выберите "Изменить поля" в разделе "Поля" и нажмите кнопку "Добавить".

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

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

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

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

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

Убедитесь, что между ними существует достаточная контрастность цвета:

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

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

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

Включите следующие свойства:

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

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