Элемент управления Подпись в Power Apps

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

Описание

В метке отображаются данные, которые вводятся как строковый литерал (текст отображается точно так, как вы его вводите) или как формула, результатом которой является строка текста. Метки часто отображаются вне других элементов управления (например, заголовок, определяющий экран), в качестве метки для другого элемента управления (например, элемента "Оценка" или "Аудио") или в коллекции для отображения определенного типа сведений об элементе.

Ключевые свойства

AutoHeight  — задайте значение true, чтобы разрешить автоматическое увеличение высоты метки для отображения всего текста. Задайте значение false для усечения текста в соответствии с настроенной высотой поля.

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

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

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

DelayOutput  — значение true позволяет отложить действие во время ввода текста.

Дополнительные свойства

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

AutoHeight — определяет, увеличивается ли автоматически значение свойства Height элемента управления, если его свойство Text содержит больше знаков, чем элемент управления может отобразить одновременно.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Live  — как средство чтения экрана произносит изменения значения свойства Text метки.

• Когда установлено значение Off, средство чтения экрана не объявляет об изменениях.
• Когда установлено значение Polite, средство чтения экрана заканчивает говорить, прежде чем объявлять о любых изменениях, произошедших, пока средство чтения экрана говорило.
• Когда установлено значение Assertive, средство чтения экрана прерывает свою работу, чтобы объявить о любых изменениях, произошедших, когда средство чтения экрана говорит.

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

Overflow — определяет, отображается ли полоса прокрутки в метке, если ее свойству Wrap присвоено значение true и значение свойства Text этого элемента управления содержит больше знаков, чем он может одновременно отобразить.

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

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

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

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

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

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

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

Role — семантическая роль текста метки, например, заголовок 1. Не меняет стиль метки, но делает вывод семантически корректным для интерпретации программами чтения с экрана.

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

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

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

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

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

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

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

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

Wrap — может ли текст переноситься на несколько строк.

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

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

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

Text(значение, "формат_текста")

Примеры

Отображение строкового литерала

• Добавьте метку и укажите для свойства Text значение "Привет, мир!" (вместе с двойными кавычками).

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

Отображение результата формулы

• Добавьте метку и укажите для его свойства Text формулу следующего вида:
  Today()

  Примечание

  Не указывайте в формуле кавычки, если только ее аргумент не является строковым литералом. В этом случае заключите аргумент (не формулу) в двойные кавычки.

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

Отображение данных в коллекции

Здесь вы создадите набор данных с названием CityPopulations, содержащий данные о численности населения в разных городах Европы. Затем вы покажете эти данные в коллекции, содержащей три метки, и укажете тип данных, отображаемых в каждой метке.

1. Добавьте кнопку и задайте следующую формулу в качестве значения свойства OnSelect:
   ClearCollect(CityPopulations, {City:"London", Country:"United Kingdom", Population:8615000}, {City:"Berlin", Country:"Germany", Population:3562000}, {City:"Madrid", Country:"Spain", Population:3165000}, {City:"Rome", Country:"Italy", Population:2874000}, {City:"Paris", Country:"France", Population:2273000}, {City:"Hamburg", Country:"Germany", Population:1760000}, {City:"Barcelona", Country:"Spain", Population:1602000}, {City:"Munich", Country:"Germany", Population:1494000}, {City:"Milan", Country:"Italy", Population:1344000})

2. Нажмите клавишу F5, нажмите кнопку, затем нажмите клавишу ESC.

3. Добавьте текстовую коллекцию и укажите для свойства Items значение CityPopulations.

   Если выбрать коллекцию, в правой области отображаются ее параметры.

4. В области Gallery1 назначьте Population для верхнего списка, City — для среднего и Country — для нижнего.

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

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

Элемент управления Label может использоваться в качестве кнопки или ссылки, если настроено поведение OnSelect. При этом применяются те же рекомендации по настройке специальных возможностей, как и для кнопок.

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

Необходимо настроить достаточный контраст для следующих элементов:

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

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

• Должно присутствовать свойство Text.

• Для свойства Live должно быть установлено значение Polite или Assertive, если средство чтения с экрана должно объявлять изменения в значении свойства Text.

  Примечание

  Средства чтения с экрана будут обрабатывать элементы управления Label как кнопки, если значение TabIndex равно нулю или больше нуля.

Поддержка пользователей со слабым зрением

• Элемент управления Label должен выглядеть как ссылка, если он используется в качестве ссылки.
  • Задайте для свойства Underline значение true.
  • Свойство HoverColor должно отличаться от элемента Color.

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

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