Елемент керування "Введення тексту" в Power Apps

  • Стаття

Поле, у якому користувач може ввести текст, числа та інші дані.

Опис

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

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

За замовчуванням – початкове значення елемента керуванням перед тим, як його змінює користувач.

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

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

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

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

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

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

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

Clear – визначає, чи показує елемент керування "Ввід даних" значок "X", який можна натиснути для очищення вмісту такого елемента керування. Працює тільки в режимі SingleLine .

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

DelayOutput – якщо встановлено значення "True", уведення тексту реєструється з півсекундною затримкою. Корисно для затримки дорогих операцій, доки користувач не завершить уведення тексту (тобто для фільтрації, коли введені дані використовуються в інших формулах).

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

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

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

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

EnableSpellCheck – визначає, чи має елемент керування "Введення тексту" використовувати функцію перевірки орфографії браузера. Ця властивість не підтримується в Power Apps для Windows.

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

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

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

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

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

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( String )

Приклади

Збір даних

  1. Додайте два елементи керування "Введення тексту" і дайте їм імена inputFirst та inputLast.

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

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

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

  3. Додайте галерею тексту із книжковою/вертикальною орієнтацією, установіть для її властивості Items значення Names (Імена), а для властивості Text елемента з ім’ям Subtitle1 значення ThisItem.FirstName (ЦейЕлемент.Ім’я).

  4. (Необов’язково) У галереї шаблонів видаліть нижній підпис з ім’ям Body1 і встановіть для властивості TemplateSize галереї значення 80.

  5. Натисніть клавішу F5, уведіть рядок тексту в елементи керування з іменами inputFirst та inputLast, а потім клацніть кнопку Додати.

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

Запит пароля

  1. Додайте елемент керування "Введення тексту", назвіть його inputPassword і встановіть для властивості Режим елемента керування значення Пароль.

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

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

  3. Натисніть клавішу F5, а потім уведіть P@ssw0rd в inputPassword.

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

  4. Щоб повернутися до робочої області за замовчуванням, натисніть клавішу Esc.

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

  6. (Необов’язково) Додайте кнопку, настройте її властивість Текст на відображення тексту Вхід, додайте таймер та забезпечте вимикання елемента керування "Введення тексту" на певний час у разі введення неправильного пароля та натискання кнопки Вхід.

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

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

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

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

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

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).