Додавання елемента керування «Рисунок» у компонованих програмах

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

Опис

За допомогою цього елемента керування користувачі можуть робити фото й завантажувати файли зображень зі свого пристрою та оновлювати джерело даних цим вмістом. На мобільному пристрої користувачу відкриється діалогове вікно вибору пристрою, де можна вибрати одну з двох дій: зробити фото або вибрати з наявних зображень.

Цей елемент керування – це згрупований елемент, який містить два елементи керування: Зображення та кнопка "Додати рисунок". Елемент керування Зображення відображає завантажене зображення або покажчик місця заповнення, якщо зображення не було завантажено. Кнопка "Додати рисунок" вимагає завантаження зображення.

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

Обмеження

Picture control має такі обмеження:

• Якщо ввімкнено функцію « Додати елемент керування зображенням iOS», зображення, імпортовані за допомогою камери або галереї, не містять метаданих, таких як орієнтація, інформація про розташування або параметри камери.

Властивості кнопки "Додати рисунок"

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

Align  – розташування тексту відносно центра його елемента керування за горизонталлю.

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

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

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

ChangePictureText – текст, який відображається на кнопці після завантаження зображення.

Color  – колір тексту в елементі керування.

DisabledBorderColor  – колір межі елемента керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled (Вимкнуто).

DisabledColor  – колір тексту в елементі керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled.

DisabledFill  – колір фону елемента керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled.

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

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

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

FocusedBorderColor  – колір межі елемента керування, коли він перебуває у фокусі.

FocusedBorderThickness  – товщина межі елемента керування, коли він перебуває у фокусі.

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

FontWeight  – стиль шрифту в елементі керування: Жирний, Напівжирний, Звичайний або Ненасичений.

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

HoverBorderColor  – колір межі елемента керування в разі наведення на нього курсору.

HoverColor  – колір тексту в елементі керування в разі наведення на нього курсору.

HoverFill  – колір фону елемента керування в разі наведення на нього курсору.

Italic  – виділення тексту в елементі керування курсивом.

Мультимедіа – ідентифікатор кліпу, який відтворюється елементом керування "Аудіо" або "Відео".

OnChange – дії, які виконуються, коли користувач змінює значення елемента керування (наприклад, налаштовує повзунок).

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

Заповнення – відстань між текстом на кнопці імпорту або експорту й краями цієї кнопки.

PressedBorderColor  – колір межі елемента керування, коли користувач його торкається або клацає.

PressedColor  – колір тексту в елементі керування, коли користувач його торкається або клацає.

PressedFill  – колір фону елемента керування, коли користувач його торкається або клацає.

Reset  – визначає, чи повертається елемент керування до значення за замовчуванням.

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

Strikethrough  – відображення лінії, що закреслює текст на елементі керування.

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

Текст – текст, який відображається на кнопці, якщо зображення не завантажилося.

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

Underline  – відображення лінії під текстом на елементі керування.

UseMobileCamera – чи використовувати безпосередньо камеру мобільного пристрою, якщо вона є. Для пристроїв Android для цієї властивості потрібно ввімкнути експериментальний параметр Покращений запис мультимедійного вмісту.

VerticalAlign – розташування тексту в елементі керування відносно центру цього елемента керування по вертикалі.

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

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

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

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

Пов’язані функції

Виправлення( DataSource, BaseRecord, ChangeRecord )

Приклади

Додавання зображень до елемента керування "Галерея зображень"

1. Додайте елемент керування Додати рисунок і тричі клацніть його.

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

2. У діалоговому вікні Відкрити виберіть файл зображення й натисніть Відкрити.

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

   Потрібні додаткові відомості про функцію Collect або інші функції?

4. Додайте елемент керування Вертикальна галерея й встановіть для властивості Елементи значення MyPix.

5. У галереї виберіть елемент керування Image й встановіть для властивості Зображення значення ThisItem.Value.

6. Натисніть клавішу F5, а потім виберіть елемент керування Button.

   Зображення з елемента керування Додати зображення відображається в елементі керування Вертикальна галерея. Якщо зображення не має однакових пропорцій з елементом керування Image в елементі керування Вертикальна галерея, для властивості ImagePosition елемента керування Image виберіть значення Припасування.

7. Клацніть елемент керування Додати рисунок (або торкніться його), виберіть інший файл зображення, натисніть Відкрити й виберіть елемент керування Button, який було додано.

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

8. (Необов’язково) Повторіть попередній крок один або кілька разів, а потім поверніться до робочої області за замовчуванням, натиснувши клавішу Esc.

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

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

Для елементів керування Button й Image застосовуються однакові рекомендації. Також враховуйте ось що.

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

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

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

• Add picture button повинна мати властивості Текст і ChangePictureText, які пропонують користувачу додати або змінити рисунок.

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

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