Елемент керування «Надпис» у Power Apps

Поле, у якому відображаються дані, як-от текст, числа, дати або грошові одиниці.

Опис

Підпис показує дані, указані як текстовий рядок, що відображається точно так само, як його було введено, або як формула, що повертає рядок тексту. Підписи часто відображаються за межами будь-якого іншого елемента керування (наприклад, банера, що визначає екран), як підпис, що визначає інший елемент керування (наприклад, елемент керування "Оцінка" або "Аудіо"), або в галереї для відображення певного типу відомостей про елемент.

Ключові властивості

AutoHeight  – якщо установлено значення "True", дозволяє автоматичне збільшення висоти підпису для відображення всього тексту. Якщо установлено значення "False", обрізає текст до заданої висоти.

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

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

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

DelayOutput  – якщо установлено значення "True", затримує дію під час вводу тексту.

Додаткові властивості

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

AutoHeight – визначає, чи підпис буде автоматично збільшувати значення властивості Height, якщо кількість символів у властивості Текст перевищує кількість, яку елемент керування може відображати одночасно.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Live  – спосіб озвучування змін значення властивості Текст підпису невізуальним екраном.

• При значенні Вимкнуто невізуальний екран не оголошуватиме змін.
• При значенні Ввічливо невізуальний екран спочатку завершить мовлення, а потім оголосить зміни, які відбулися за час мовлення.
• При значенні Наполегливо невізуальний екран перерветься і оголосить зміни, які відбулися за час мовлення.

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

Overflow – визначає, чи з’являється у підписі смуга прокручування, якщо для властивості Wrap цього елемента керування встановлено значення True, а кількість символів у властивості Текст перевищує кількість, яку елемент керування може відображати одночасно.

PaddingBottom  – відстань між текстом в елементі керування та нижнім краєм цього елемента керування.

PaddingLeft  – відстань між текстом в елементі керування та лівим краєм цього елемента керування.

PaddingRight  – відстань між текстом в елементі керування та правим краєм цього елемента керування.

PaddingTop  – відстань між текстом в елементі керування та верхнім краєм цього елемента керування.

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

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

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

Role – семантична роль тексту підпису, як-от "Heading 1" (Заголовок 1). Не змінює стиль підпису, але робить виведення семантично правильним для інтерпретації невізуальними екранами.

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

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

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

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

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

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

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

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

Wrap – визначає необхідність перенесення тексту на кілька рядків.

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

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

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

Текст( Number, "FormatCodes" )

Приклади

Відображення текстового рядка

• Додайте підпис і введіть для його властивості Текст значення "Привіт, світе" (включно з прямими лапками).

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

Відображення результату формули

• Додайте підпис і настройте його властивість Текст подібно до наведеної нижче формули.
  Today()

  Примітка

  У формулі лапки використовуються, тільки якщо аргумент формули є текстовим рядком. У такому разі в лапки береться аргумент, але не формула.

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

Відображення даних у галереї

У цій процедурі буде створено колекцію з ім’ям CityPopulations (Чисельність населення міст), що містить дані про чисельність населення різних міст Європи. Потім ці дані відобразяться в галереї, що містить три підписи, і буде вказано тип даних, які показуватиме кожен підпис.

1. Додайте кнопку та настройте її властивість OnSelect відповідно до нижченаведеної формули.
   ClearCollect(CityPopulations, {City:"Лондон", Country:"Сполучене Королівство", Population:8615000}, {City:"Берлін", Country:"Німеччина", Population:3562000}, {City:"Мадрид", Country:"Іспанія", Population:3165000}, {City:"Рим", Country:"Італія", Population:2874000}, {City:"Париж", Country:"Франція", Population:2273000}, {City:"Гамбург", Country:"Німеччина", Population:1760000}, {City:"Барселона", Country:"Іспанія", Population:1602000}, {City:"Мюнхен", Country:"Німеччина", Population:1494000}, {City:"Мілан", Country:"Італія", Population:1344000})

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

3. Додайте галерею тексту і встановіть для її властивості Items значення CityPopulations.

   Якщо вибрано галерею, в області праворуч відображатимуться параметри для цієї галереї.

4. В області Gallery1 (Галерея1) установіть для верхнього списку значення Population (Чисельність населення), для середнього списку – City (Місто), а для нижнього списку – Country (Країна).

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

Незважаючи на свою назву, елемент керування Підпис не має використовуватися як підпис для іншого елемента керування. Його можна використовувати для відображення будь-якого фрагменту тексту.

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

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

Необхідно налаштувати відповідну контрастність кольору для таких елементів:

• повинна забезпечуватися належна контрастність кольору між властивостями Color та Fill;
• мають застосовуватися стандартні вимоги до контрастності кольору (у разі використання як кнопки або посилання).

Підтримка невізуального екрана

• Обов’язковою є властивість Текст.

• Для властивості Live повинно бути встановлено значення Polite (Люб’язний) або Assertive (Ствердний), якщо невізуальний екран має озвучувати зміни значення властивості Текст.

  Примітка

  Невізуальні екрани сприйматимуть елементи керування Підпис як кнопки, якщо для властивості TabIndex установлено значення "нуль" або більше.

Підтримка засобів для користувачів зі слабким зором

• Підпис має виглядати як посилання, якщо цей елемент керування використовується як посилання.
  • Установіть для властивості Underline значення True.
  • Значення властивостей HoverColor і Color мають відрізнятися.

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

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