Элемент управления Добавление изображения в приложениях на основе холста
Делает снимок или загружает изображения с локального устройства.
Описание:
С помощью этого элемента управления пользователи могут делать снимки или передавать файлы изображений со своих устройств, а также обновлять источник данных с применением этого содержимого. На мобильном устройстве пользователя откроется диалоговое окно выбора устройства, в котором можно выбрать один из вариантов: сделать снимок или выбирать уже имеющийся.
Этот элемент управления является групповым и состоит из двух элементов — Изображение и Кнопка "Добавить изображение". Элемент управления Изображение отображает переданное изображение или заполнитель, если изображение не передавалось. Кнопка "Добавление изображения" предлагает пользователю отправить изображение.
Свойства элемента управления Изображение см. в разделе Справка по элементу управления Изображение.
Ограничения
Элемент управления «Изображение» имеет следующие ограничения:
- При использовании элемента управления Добавить изображение в 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
Добавьте элемент управления Добавление изображения и щелкните его три раза.
Не знаете, как добавить, назвать и настроить элемент управления?
В диалоговом окне Открыть выберите файл изображения и нажмите Открыть.
Добавьте элемент управления Кнопка, переместите его под элемент управления Добавление изображения и укажите для свойства OnSelect элемента управления Кнопка следующую формулу:
Collect(MyPix, AddMediaButton1.Media)Нужны дополнительные сведения о функции Collect или других функциях?
Добавьте элемент управления Vertical gallery и укажите для его свойства Items значение MyPix.
Выберите элемент управления Изображение в коллекции и установите для его свойства Изображение значение ThisItem.Value.
Нажмите клавишу F5 и выберите элемент управления Кнопка.
Изображение из элемента управления Добавление изображения появляется в элементе управления Вертикальная галерея. Если пропорции вашего изображения отличаются от элемента управления Изображение в элементе управления Vertical gallery, укажите для свойства ImagePosition элемента управления Изображение значение Fit.
Нажмите элемент управления Добавление изображения, выберите другой файл изображения, нажмите Открыть, а затем нажмите добавленный вами элемент управления Кнопка.
В элементе управления Галерея изображений появляется второе изображение.
(Необязательно) Повторите предыдущее действие один и несколько раз, а затем нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.
Для сохранения изображений на локальном устройстве используйте функцию SaveData, а для обновления источника данных — функцию Patch.
Руководство по настройке специальных возможностей
Применяются те же рекомендации, что и для элементов управления Кнопка и Изображение. Кроме того, учитывайте следующее:
Контрастность цветов
- Текст и фон элемента управления Кнопка "Добавление изображения" должны быть достаточно контрастными. Так как в переданном изображении могут присутствовать разные цвета, используйте непрозрачное значение свойства Fill для элемента управления Кнопка "Добавление изображения", чтобы гарантировать достаточную контрастность.
Поддержка средства чтения с экрана
- Кнопка "Добавление изображения" должна иметь свойства Text и ChangePictureText, которые позволяют вывести запрос о добавлении или изменении изображения для пользователя.
Поддержка клавиатуры
- Для свойства TabIndex элемента управления Кнопка "Добавление изображения" должно быть задано значение ноль или больше, чтобы пользователи могли использовать навигацию с помощью клавиатуры.
- Для элемента управления Кнопка "Добавление изображения" должны быть предусмотрены явно различимые индикаторы фокуса. Для этого используются элементы FocusedBorderColor и FocusedBorderThickness.
Примечание
Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).
Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).