Добавление элемента управления рисунками в приложениях холста

Выполняет фотографию или загружает изображения с локального устройства.

Description

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

Этот элемент управления представляет собой сгруппированные элементы управления, содержащие два элемента управления: изображение и кнопка "Добавить рисунок". Элемент управления "Изображение" отображает отправленное изображение или заполнитель, если изображение не было отправлено. Кнопка "Добавить рисунок" запрашивает отправку изображения.

Дополнительные сведения см. в справочнике по элементу управления "Изображение " для свойств изображения .

Ограничения

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

• При использовании элемента управления "Добавление рисунка " в iOS изображения, импортированные с помощью камеры или коллекции, не содержат метаданные, такие как ориентация, сведения о расположении или параметры камеры.

Добавление свойств кнопки рисунка

AccessibleLabel — метка для средств чтения с экрана. Следует описать цель добавления рисунка.

Выравнивание — расположение текста относительно горизонтального центра его элемента управления.

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

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

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

ChangePictureText — текст, который отображается на кнопке при отправке изображения.

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

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

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

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

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

Ошибка . Если возникла проблема с отправкой изображения, это свойство будет содержать соответствующую строку ошибки.

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

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

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

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

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

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

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

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

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

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

Носитель — идентификатор клипа, воспроизводимого звуком или видео.

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

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

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

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

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

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

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

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

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

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

Текст — текст , который отображается на кнопке, когда изображение не было отправлено.

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

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

UseMobileCamera — следует ли использовать мобильную камеру напрямую, когда она доступна. Если задано значение TRUE , пользователи могут сфотографироваться с помощью камеры и отключить отправку существующих изображений из коллекции устройств.

VerticalAlign — расположение текста в элементе управления относительно вертикального центра этого элемента управления.

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

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

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

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

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

Patch( DataSource, BaseRecord, ChangeRecord )

Примеры

Добавление изображений в элемент управления "Коллекция образов"

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

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

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

3. Добавьте элемент управления Button , переместите его под элементом управления Add picture и задайте свойству OnSelect для элемента управления Button следующую формулу:
   Collect(MyPix, AddMediaButton1.Media)

   Хотите получить дополнительные сведения о функции Сбора или других функциях?

4. Добавьте элемент управления "Вертикальная коллекция " и задайте для свойства Items значение MyPix.

5. Выберите элемент управления Image в коллекции и задайте для свойства Image значение ThisItem.Value.

6. Нажмите клавишу F5 и выберите элемент управления "Кнопка ".

   Изображение из элемента управления "Добавление рисунка " отображается в элементе управления "Вертикальная коллекция ". Если изображение не имеет того же пропорциональности, что и элемент управления Image в элементе управления "Вертикальная коллекция" , задайте для свойства ImagePosition элемента управления Image значение Fit.

7. Щелкните или коснитесь элемента управления "Добавить рисунок ", нажмите или коснитесь другого файла изображения, нажмите или коснитесь "Открыть", а затем выберите элемент управления "Кнопка ", который вы добавили.

   Второй образ отображается в элементе управления "Коллекция образов ".

8. (необязательно) Повторите предыдущий шаг один или несколько раз, а затем вернитесь в рабочую область по умолчанию, нажав клавишу ESC.

Используйте функцию SaveData для локального сохранения изображений или функции patch для обновления источника данных.

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

Те же рекомендации для кнопки и изображения применяются. Кроме того, рассмотрим следующее:

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

• Кнопка добавления рисунка должна иметь достаточную контрастность между текстом и фоном. Так как отправленное изображение может иметь различные цвета, используйте непрозрачную заливку на кнопке "Добавить рисунок ", чтобы обеспечить согласованность контрастности.

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

• Кнопка "Добавить рисунок " должна иметь текст и ChangePictureText , который предложит пользователю добавить или изменить рисунок.

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

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