Добавление элемента управления Ввод с помощью пера в Power Apps

Элемент управления Ввод с помощью пера позволяет рисовать, стирать и выделять области изображения.

Описание

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

Ограничения

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

• Элемент управления «Ввод с помощью пера» обеспечивает лишь частичную поддержку рисования с помощью мыши или сенсорного ввода в приложении Windows. В этом случае могут получаться прерывистые штрихи. Для непрерывного рисования необходимо использовать перо или запустить приложение в браузере.

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

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

Color  — цвет штрихов.

Mode — режим работы элемента управления: Draw (Рисование) или Erase (Стирание). Режим "Select" (Выбор) является устаревшим.

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

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

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

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

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

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

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

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

Input — не рекомендуется. Указывает, поддерживает ли подсистема ввода мышь, перо или сенсорный ввод. Если установлено значение по умолчанию (7), поддерживаются все три способа.

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

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

SelectionThickness — толщина инструмента выделения для элемента управления Ввод с помощью пера.

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

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

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

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

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

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

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

Связанные функции

Collect( CollectionName, DatatoCollect )

Пример

Создание набора изображений

1. Добавьте в приложение элемент управления Ввод с помощью пера, назовите его MyDoodles и присвойте его свойству ShowControls значение true.

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

2. Добавьте элемент управления Кнопка и расположите его под элементом MyDoodles. Затем задайте для свойства Text этого элемента управления Кнопка значение Добавить.

3. Назначьте свойству OnSelect элемента управления Кнопка следующую формулу:
   Collect(Doodles, {Sketch:MyDoodles.Image})

4. Добавьте элемент управления Галерея изображений и расположите его под элементом Кнопка. Затем измените ширину элемента управления Галерея изображений так, чтобы в ней отображалось три элемента.

5. Назначьте свойству Items элемента управления Галерея изображений значение Doodles и нажмите клавишу F5.

6. Нарисуйте изображение в элементе MyDoodles и щелкните элемент управления Кнопка.

   Нарисованное вами изображение появится в элементе управления Галерея изображений.

7. (Необязательно) В элементе управления Ввод с помощью пера щелкните значок (или коснитесь значка), чтобы очистить нарисованное изображение, нарисуйте другое изображение, а затем щелкните элемент управления Кнопка.

8. В элементе управления Галерея изображений назначьте свойству OnSelect элемента управления Изображение следующую формулу:
   Remove(Doodles, ThisItem)

9. Удалите рисунок, щелкнув его (или коснувшись его) в элементе управления Галерея изображений.

Для сохранения рисунков на локальном устройстве используйте функцию SaveData, а для сохранения в источнике данных — функцию Patch.

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

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

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

• BorderColor и цвет за пределами элемента управления (если есть граница)
• Fill и цвет за пределами элемента управления (если нет границы).

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

• Должно присутствовать свойство AccessibleLabel.

  Важно!

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

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