Добавление элемента управления Text input в Power Apps

Поле, в котором пользователь может вводить текст, числа и другие данные.

Описание

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

Основные свойства

Default  — начальное значение элемента управления до его изменения пользователем.

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

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

AccessibleLabel — метка для средств чтения с экрана.

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

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

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

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

Clear — определяет, отображается ли в текстовом поле значок "X", с помощью которого пользователь может очистить содержимое элемента управления.

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

DelayOutput — при значении true вводимые пользователем данные регистрируются после задержки в половину секунды. Можно задерживать ресурсоемкие операции, пока пользователь не завершит ввод текста (например, для фильтрации, если входные данные используются в других формулах).

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

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

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

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

EnableSpellCheck — должен ли элемент управления ввода текста использовать функцию проверки орфографии в браузере. Power Apps для Windows не поддерживает это свойство.

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

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

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

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

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

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

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

HintText — текст светло-серого цвета, отображаемый в пустом текстовом поле.

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

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

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

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

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

MaxLength — количество символов, которые может ввести пользователь в элементе управления "Текстовое поле".

Mode — определяет режим SingleLine (Однострочный), MultiLine (Многострочный) или Password (Пароль).

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

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

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

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

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

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

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

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

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

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

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

RadiusTopLeft  — градус, до которого округляется верхний левый угол элемента управления.

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

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

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

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

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

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

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

VirtualKeyboardMode — тип виртуальной клавиатуры, текстовая или цифровая, которая отображается на сенсорном экране пользователя приложения. Свойство Format определяет значение по умолчанию. Поддержка устройств варьируется. Устройства под управлением iOS должны иметь как минимум версию 12.2. Рекомендуется версия Android 9.0, и возможности цифровых клавиатур могут отличаться для устройств Android. Windows 10 не поддерживает это свойство.

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

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

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

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

DateTimeValue( Строка )

Примеры

Сбор данных

  1. Добавьте два элемента управления "Text input" и назовите их inputFirst и inputLast.

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

  2. Добавьте кнопку, укажите для ее свойства Текст значение Добавить, а для свойства OnSelect следующую формулу:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

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

  3. Добавьте коллекцию текстов в портретной (вертикальной) ориентации, укажите для свойства Items значение Names, а для свойства Текст элемента Subtitle1 значение ThisItem.FirstName.

  4. (Необязательно.) В коллекции шаблонов удалите нижнюю метку с именем Body1 и укажите для свойства TemplateSize коллекции значение 80.

  5. Нажмите клавишу F5, введите строку текста в элементах inputFirst и inputLast, затем нажмите кнопку Добавить.

  6. (Необязательно.) Добавьте другие имена в коллекцию, а затем нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

Запрос пароля

  1. Добавьте элемент управления Text input, назовите его inputPassword и укажите для свойства Mode значение Password.

  2. Добавьте метку и установите в ее свойстве Текст формулу:
    If(inputPassword.Text = "P@ssw0rd", "Доступ предоставлен", "Доступ запрещен")

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

  3. Нажмите клавишу F5 и введите P@ssw0rd в inputPassword.

    Когда вы закончите вводить пароль, в метке вместо значения Доступ запрещен будет отображаться значение Доступ предоставлен.

  4. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

  5. (Необязательно.) Добавьте стрелку, настройте ее для перехода на другой экран и отображайте только после того, как пользователь введет пароль.

  6. (Необязательно.) Добавьте кнопку, настройте ее свойство Текст для отображения значения Войти, добавьте таймер и отключайте элемент управления Text input на определенное время, если пользователь вводит неправильный пароль и нажимает кнопку Войти.

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

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

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

  • Должен присутствовать элемент AccessibleLabel.

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

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