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

Елемент керування "Ввід за допомогою пера" в Power Apps

  • Стаття

Елемент керування, у якому користувач може малювати, стирати та виділяти області зображення.

Опис

Користувач може використовувати цей елемент керування як дошку, малюючи діаграми та пишучи слова, які можна перетворити на друкований текст.

Обмеження

Елемент керування введенням пера має такі обмеження:

  • Елемент керування пером має лише часткову підтримку малювання за допомогою миші або сенсорного введення в програмі Windows. Розчерки можуть бути переривчастими. Для плавного малювання використовуйте перо або запустіть програму в браузері.

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

Зображення – вихідна властивість, що представляє зображення, намальоване користувачем.

Color  – колір ліній контуру вводу.

Mode – елемент керування може знаходитися в режимах Малювання або Стирання. Режим "Виділення" було вилучено.

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

AccessibleLabel  – підпис для невізуальних екранів. Можна використовувати для опису призначення елемента керування, а також альтернативних методів вводу.

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

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

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

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

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

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

Input – вилучено. Підтримка вводу за допомогою миші, пера або дотиків. Значення за замовчуванням (7) підтримує всі три варіанти.

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

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

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

ShowControls – визначає, чи відображає аудіо- або відеопрогравач такі елементи, як кнопка відтворення й повзунок гучності, а елемент керування пером – піктограми для малювання, стирання та очищення.

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

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

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

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

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

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

Collect( CollectionName, DatatoCollect )

Приклад

Створення набору зображень

  1. Додайте елемент керування Ввід за допомогою пера, назвіть його MyDoodles та встановіть для властивості ShowControls елемента керування значення True.

    Не знаєте, як додати, іменувати та настроїти елемент керування?

  2. Додайте елемент керування Button, розмістіть його під елементом MyDoodles та настройте властивість Текст елемента керування Button так, щоб відображалося слово Додати.

  3. Настройте властивість OnSelect елемента керування Button відповідно до нижченаведеної формули.
    Collect(Doodles, {Sketch:MyDoodles.Image})

  4. Додайте елемент керування Галерея зображень, розмістіть його під елементом керування Button та зменште ширину елемента керування Галерея зображень, щоб він відображав лише три об’єкти.

  5. Установіть для властивості Items елемента керування Галерея зображень значення Doodles (Замальовка), а потім натисніть клавішу F5.

  6. Намалюйте зображення в елементі керування MyDoodles, а потім клацніть елемент керування Button (або торкніться його).

    Намальоване зображення відобразиться в елементі керування Галерея зображень.

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

  8. В елементі керування Image gallery настройте властивість OnSelect елемента керування Image відповідно до нижчезазначеної формули.
    Remove(Doodles, ThisItem)

  9. Видаліть малюнок, клацнувши або торкнувшись його в елементі керування Галерея зображень.

Збережіть свої малюнки на локальному рівні за допомогою функції SaveData або збережіть їх у джерелі даних за допомогою функції Patch.

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

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

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

  • BorderColor та кольором за межами елемента керування (якщо є межа);
  • Fill та кольором за межами елемента керування (якщо межа відсутня).

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

  • Має бути присутня властивість AccessibleLabel.

    Важливо

    Увід за допомогою пера недоступний для користувачів невізуального екрана. Завжди забезпечуйте альтернативну форму вводу. Наприклад, якщо потрібен ескіз, спробуйте додати елемент керування Add picture, щоб користувачі могли завантажувати зображення. Можуть пропонуватися обидва методи, а користувач може вибрати для себе більш зручний із них.

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

Важливо

Увід за допомогою пера недоступний для користувачів клавіатури. Завжди забезпечуйте альтернативну форму вводу. Наприклад, якщо підпис є обов’язковим, спробуйте додати елемент керування Text input, щоб користувач міг ввести своє ім’я. Можуть пропонуватися обидва методи, а користувач може вибрати для себе більш зручний із них.

Примітка

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

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