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

Можно использовать следующие события виджета для выполнения сервисов данных или функций, когда значение виджета обновляется во время выполнения:

Виджет "Текстовое поле" инициирует два связываемых события:

События виджета можно использовать для активации функций, сервисов данных или сервисов в виджетах. Например, можно связать события с проверяющей функцией, чтобы выполнить проверку по мере ввода данных или при нажатии клавиши Enter.

Можно включать ReadOnly свойство, чтобы предотвратить изменения текста во время выполнения. Например, можно использовать это свойство, чтобы предотвращать изменения до тех пор, пока не будет включен выключатель или установлен флажок в мэшапе. Если включен режим только чтения, можно выбирать и копировать текст, но нельзя править, вырезать или удалить текущее значение. Чтобы изменить значение текстового поля только для чтения, введите значение для свойства Text во время конструирования. Можно также привязать источник данных к свойству, чтобы изменять текстовое значение во время выполнения.

Можно ограничить ввод текста в текстовом поле определенным числом символов одним из следующих способов.

Чтобы добавить счетчик, отображающий число символов в текстовом поле, установите для свойства Counter значение ИСТИНА. Свойство MaxNumberOfCharacters используется для задания предела символов, включая пробелы. На следующем рисунке показан виджет "Текстовое поле" с видимым счетчиком и максимальным числом символов, равным 10.

При достижении предела символа цвет счетчика изменяется:

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

Можно использовать свойство Icon для отображения значка в текстовом поле. Значок автоматически отображается в левой части виджета. Можно выбрать значок из предоставленных значков SVG, доступных в платформе. Дополнительные сведения о доступных значках см. в разделе Использование значков SVG.

Можно использовать свойство Mask, чтобы указать шаблон ввода для числовых, алфавитных и буквенно-цифровых символов. При определении шаблона в поле ввода добавляются направляющие местозаполнителей. Направляющие представляют собой линии, используемые для указания шаблона текста, который пользователь может ввести в текстовое поле. В дополнение к требуемому шаблону свойство задает количество символов в текстовом поле. Можно создавать шаблоны, используя следующие специальные символы:

Чтобы создать шаблон, объедините специальные символы в строку, представляющую требуемые входные данные. Например, следующие шаблоны представляют различные типы входных данных:

На следующем рисунке показаны направляющие для числового шаблона 999–999–999–999, содержащего 4 трехзначных числа во время выполнения:

Шаблон используется для задания формата числа в дополнение к числу цифр. В этом примере можно ввести любое 12-значное число, например 256120233234. По мере ввода символы подчеркивания (_) заменяются цифрами.

Число подчеркиваний зависит от общего числа символов, заданных в шаблоне во время конструирования. При вводе числа с меньшим, чем в шаблоне, числом знаков ввод остается незавершенным. Маску следует использовать для определения шаблонов с определенным количеством символов, таких как номера телефонов или почтовые индексы. Старайтесь не использовать маску, если входные данные не представляют определенное число символов, например денежную сумму.

Свойства виджета "Текстовое поле" перечислены ниже.

В дополнение к общим свойствам проверки можно использовать свойства MaxLength и MinLength для проверки количества символов в виджете "Текстовое поле".

Можно настроить сообщения об отказе по умолчанию с помощью свойств MaxLengthFailureMessage и MinLengthFailureMessage. Максимальное и минимальное значения отображаются в сообщениях с использованием параметра ${value}.

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

В следующей таблице перечислены свойства проверки, доступные на панели Проверка в ThingWorx 9.3.4 и более поздних версий.