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

Елемент керування "Вкладення" в Power Apps

  • Стаття

Елемент керування, який дає змогу користувачам завантажувати файли на свій пристрій, а також передавати файли до списку, створеного за допомогою Microsoft Lists, або до таблиці Microsoft Dataverse, або видаляти їх звідти.

Опис

Елемент керування Вкладення дозволяє відкривати та видаляти файли зі списку або таблиці Dataverse або додавати їх туди.

Обмеження

Елемент керування "Вкладення" має такі обмеження.

  1. Елемент керування «Вкладення» підтримує лише списки та таблиці Dataverse як джерела даних. Вирази, які перетворюють ці джерела даних на таблиці, наприклад, за допомогою функції ForAll, не підтримуються.

  2. Функції передавання та видалення працюють лише всередині форми. Елемент керування "Вкладення" буде вимкнуто, якщо користувач працює в режимі редагування, а не всередині форми. Щоб зберегти додавання та видалення файлів, користувач програми повинен зберегти форму. Через це обмеження елемент керування "Вкладення" недоступний на вкладці Вставлення, але відображається у формі, коли поле форми "Вкладення" увімкнуто у формі SharePoint або Dataverse.

  3. Елемент керування «Вкладення» у веббраузері дає змогу вибирати кілька файлів, а також використовувати функцію перетягування. Проте, під час використання елемента керування «Вкладення» на Power Apps Mobile, можна додавати файли тільки по одному.

Ключові властивості

Елементи – стовпець Вкладення в списку або таблиці Dataverse. Колекціїй Таблиці не підтримуються.

MaxAttachments – максимальна кількість файлів, які може прийняти елемент керування.

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

OnAddFile – дії, які виконуються, коли користувач додає нове вкладення файлу.

OnRemoveFile – дії, які виконуються після видалення наявного вкладення користувачем.

OnUndoRemoveFile – дії, які виконуються після відновлення видаленого вкладення користувачем.

Додаткові властивості

AccessibleLabel  – підпис для невізуальних екранів. Опис призначення вкладень.

AddAttachmentText – текст підписів для посилання, яке використовується, щоб додати нове вкладення.

BorderColor  – колір межі елемента керування.

BorderStyle  – визначає стиль межі елемента керування: Суцільна, Штрихова, Пунктирна або Немає.

BorderThickness  – товщина межі елемента керування.

Color  – колір тексту в елементі керування.

DisabledBorderColor  – колір межі елемента керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled (Вимкнуто).

DisabledColor  – колір тексту в елементі керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled.

DisabledFill  – колір фону елемента керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled.

DisplayMode  – визначає, чи елемент керування дозволяє додавати і видаляти файли (Редагування), лише відображає дані (Перегляд) або ж є вимкнутим (Вимкнуто).

[DropTargetBackgroundColor] – колір фону перетягнутого цільового об’єкта елемента керування.

[DropTargetBorderColor] – колір межі перетягнутого цільового об’єкта елемента керування.

[DropTargetBorderStyle]  – визначає стиль межі перетягнутого цільового об’єкта елемента керування: Суцільна, Штрихова, Пунктирна або Немає.

[DropTargetBorderThickness] – товщина межі перетягнутого цільового об’єкта елемента керування.

[DropTargetTextColor] – колір тексту перетягнутого цільового об’єкта елемента керування.

Fill  – колір фону елемента керування.

FocusedBorderColor  – колір межі елемента керування, коли він перебуває у фокусі.

FocusedBorderThickness  – товщина межі елемента керування, коли він перебуває у фокусі.

Height  – відстань між верхнім і нижнім краями елемента керування.

Font  – ім’я сімейства шрифтів, що використовується для відображення тексту.

FontWeight  – стиль шрифту в елементі керування: Жирний, Напівжирний, Звичайний або Ненасичений.

HoverBorderColor  – колір межі елемента керування в разі наведення на нього курсору.

HoverColor  – колір тексту в елементі керування в разі наведення на нього курсору.

HoverFill  – колір фону елемента керування в разі наведення на нього курсору.

Italic  – виділення тексту в елементі керування курсивом.

MaxAttachmentsText – текст, який замінює посилання "Вкласти файл", якщо елемент керування містить максимально допустиму кількість файлів.

NoAttachmentsText – інформаційний текст, який відображається користувачу, коли у вкладенні немає файлів.

Заповнення – відстань між текстом на кнопці імпорту або експорту й краями цієї кнопки.

PressedBorderColor  – колір межі елемента керування, коли користувач його вибирає.

PressedColor – колір тексту в елементі керування під час вибору його користувачем.

PressedFill  – колір фону елемента керування, коли користувач його вибирає.

Скинути – повертає всі зміни в елементі керування вкладеннями до попередньо збереженого стану.

Size  – розмір шрифту тексту, що відображається на елементі керування.

Strikethrough  – відображення лінії, що закреслює текст на елементі керування.

TabIndex  – порядок переходів за допомогою клавіатури відносно інших елементів керування.

Tooltip  – пояснювальний текст, що з’являється в разі наведення курсору на елемент керування.

Underline  – відображення лінії під текстом на елементі керування.

Visible  – відображення або приховання елемента керування.

Width  – відстань між лівим і правим краями елемента керування.

X  – відстань між лівим краєм елемента керування та лівим краєм його батьківського контейнера (або екрана, якщо батьківський контейнер відсутній).

Y  – відстань між верхнім краєм елемента керування та верхнім краєм батьківського контейнера (або екрана, якщо батьківський контейнер відсутній).

Приклад

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

  2. Виберіть елемент керування Форма відображення в поданні дерева в лівій частині. Замість нього також можна використовувати елемент Форма редагування.

  3. Виберіть Джерело даних на вкладці «Властивості» на панелі параметрів праворуч, а потім виберіть список, до якого ви підключились.

  4. Виберіть Редагувати поля в розділі Поля й натисніть Додати поле.

  5. Виберіть поле Вкладення й натисніть кнопку Додати.

    Поле «Вкладення», пов’язане зі списком, відображатиметься у формі.

Додаткові відомості про додавання та налаштування елемента керування

Рекомендації щодо спеціальних можливостей

Контрастність кольору

Необхідно налаштувати відповідну контрастність кольору для таких елементів:

  • ItemColor та ItemFill
  • ItemHoverColor та ItemHoverFill
  • ItemPressedColor та ItemPressedFill
  • AddedItemColor та AddedItemFill
  • RemovedItemColor та RemovedItemFill
  • ItemErrorColor та ItemErrorFill
  • AddAttachmentColor та Заливка
  • MaxAttachmentsColor та Заливка
  • NoAttachmentsColor та Заливка

Це додаткова вимога до стандартних вимог до контрастності кольору.

Підтримка зчитування екрана

Обов’язково потрібні такі властивості:

Підтримка клавіатури

  • Для властивості TabIndex має бути встановлено значення "нуль" або більше, щоб користувачі клавіатури могли перейти до неї.
  • Індикатори фокусу мають бути чітко видимі. Для досягнення чіткості скористайтеся властивостями FocusedBorderColor та FocusedBorderThickness.

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).