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

Делает снимок или загружает изображения с локального устройства.

Описание:

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

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

Свойства элемента управления Изображение см. в разделе Справка по элементу управления Изображение.

Ограничения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FontWeight  — толщина текста в элементе управления: Bold (Жирный), Semibold (Полужирный), Normal (Обычный) или Lighter (Очень тонкий).

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

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

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

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

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

Мультимедиа — идентификатор клипа, воспроизводимого элементом управления Аудио или Видео.

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

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

Padding  — расстояние между текстом кнопки "Импорт" или "Экспорт" и границами кнопки.

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

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

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

Reset  — определяет, возвращается ли элемент управления к значению по умолчанию.

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

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

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

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

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

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

UseMobileCamera — следует ли использовать мобильную камеру напрямую, если она доступна. Для устройств Android это свойство требует, чтобы была включена экспериментальная настройка Улучшенный захват мультимедиа.

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

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

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

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

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

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

Patch( DataSource, BaseRecord, ChangeRecord )

Примеры

Добавление изображений в элемент управления Изображение gallery

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

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

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

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

   Нужны дополнительные сведения о функции Collect или других функциях?

4. Добавьте элемент управления Vertical gallery и укажите для его свойства Items значение MyPix.

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

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

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

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

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

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

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

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

Применяются те же рекомендации, что и для элементов управления Кнопка и Изображение. Кроме того, учитывайте следующее:

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

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

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

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

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

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