Текстовое поле представляет собой область для ввода информации при помощи клавиатуры во время управления установкой или для вывода информации на экран. Текстовые поля предназначены для задания или изменения значений точек данных или для отображения значений точек данных или сообщений. Текстовые поля, используемые для ввода, передают введенные пользователем данные в «КАСКАД Цифра», а поля, используемые для вывода данных, отображают значения. При помощи текстовых полей пользователям также может быть предоставлена возможность внесения изменений в отображаемые значения. Информация в Текстовом поле может отображаться в формате целых чисел, чисел с плавающей точкой, а также в строковом формате (т.е. в виде последовательности любых букв, чисел и знаков). При помощи формата «Пароль» возможно визуальное скрытие вводимой информации. При этом вводимые символы отображаются в виде ряда звездочек («****»). При вводе используется заданный в текущий момент шрифт. Имеется возможность использования различных вариантов формата времени. Для некоторых типов данных (integers (целые числа), floats (числа с плавающей точкой), time (время)) доступны свойства «Ведущие нули«, «Пусто, если ноль» и «Экспоненциальный» [формат].
Контроль ввода
При вводе информации в Текстовое поле осуществляется контроль вводимой информации на предмет соответствия выбранному формату. Например, в текстовом поле, для которого задан формат целых чисел, невозможен ввод чисел с плавающей точкой или букв. Сценарии выполняются только в том случае, если вводимая информация соответствует выбранному формату. Допускается использование следующих форматов:
- строка (string): все символы
- целое (integer): «+», «-» 0-9
- плавающая точка (float): «+», «-«, «.» 0-9, e (для экспоненциального формата)
- экспоненциальный (exponential)
- пароль (password): все символы
- время (time): YYYY.MM.DD HH:MM:SS.mmm (ГГГГ.ММ.ДД ЧЧ.ММ.СС.мс), местные дата и время, местная дата, местное время и пользовательская настройка
Более подробная информация представлена в разделе «Строка управления форматом«.
ПРИМЕЧАНИЕ
Для применения введенных данных необходимо нажать клавишу Ввод (Enter). При вводе данных и последующем щелчке кнопкой мыши по другому объекту без нажатия клавиши Ввод (Enter) происходит сброс введенных данных.
Рисунок: Текстовое поле
ПРОЦЕСС СОЗДАНИЯ ТЕКСТОВОГО ПОЛЯ
- Щелкните левой кнопкой мыши по пиктограмме с изображением текстового поля
. - Визуально выберите в рабочей области панели точку, в которой будет находиться один из углов Текстового поля, и переместите курсор мыши в данную точку. Нажмите и удерживайте нажатой левую кнопку мыши. Визуально выберите в рабочей области панели точку, в которой будет находиться противоположный угол Текстового поля, и, удерживая нажатой левую кнопку мыши, переместите курсор мыши в данную точку. Отпустите кнопку мыши для завершения создания Текстового поля.
- Откройте Редактор свойств.
- При необходимости измените имя объекта (Имя (Name)).
- В Редакторе свойств щелкните левой кнопкой мыши по свойству «Формат текста» и задайте необходимый формат в открывшемся диалоговом окне.
Рисунок: Диалоговое окно «Формат текста»
В окне могут быть заданы следующие свойства:
- Тип данных: Целое (Integer), Плавающая точка (Float), Строка, Пароль или Время.
- Символы: Максимальное количество символов.
- Количество знаков до запятой и знаков после запятой (Точность).
- Выравнивание: По левому краю, По правому краю, По центру
- Для целых чисел, чисел с плавающей точкой и времени имеется возможность выбора опций «Пусто, если ноль» (число не будет отображаться, если оно содержит только нули. Для данных типа времени данная опция применяется к нулевому времени (Null)), «Ведущие нули» или «Экспоненциальный» (только для значений с плавающей точкой).
В поле «Пример» в нижней части окна «Формат текста» отображается пример, соответствующий выбранным опциям.
- В Редакторе свойств может быть также задан формат текста (свойство «Шрифт«).
ПРИМЕР
В примере ниже, переменной точки данных при помощи сценария присваивается числовое значение 1 при вводе в качестве пароля последовательности символов «PassWD1». Для текстового поля выбран формат «Пароль» (см. окно «Формат текста» выше), в этой связи визуальное чтение пароля при вводе невозможно. Функция «getValue()» присваивает переменной «passw» значение, соответствующее вводимым в текстовое поле данным. В случае сопоставления данного сценария событию «Command», пароль будет записываться в переменную при нажатии клавиши Ввод (Enter). В случае соответствия введенного пароля последовательности символов «PassWD1», при помощи функции «dpSet()» переменной точки данных «ExampleDP_Arg1» присваивается значение 1, в противном случае — 0.
| main() { string passw; getValue(«», «text», passw); if (passw == «PassWD1»} dpSet(«ExampleDP_Arg1.:_original.._value», 1); else dpSet(«ExampleDP_Arg1.:_original.._value», 0); } |
Информация о функциях языка Control, применимых к Текстовому полю, приведена в разделе «Язык сценариев Control/Функции для работы с графическими объектами/Текстовое поле (функции Control)«.
ВНИМАНИЕ
В том случае, если сценарий сопоставлен событию «Сommand» Текстового поля, то при переводе фокуса на другой объект при помощи клавиши табуляции, происходит сброс изменений, внесенных в текстовое поле. При этом восстанавливается ранее введенный в текстовое поле текст.
ПРИМЕЧАНИЕ
Для текстовых полей доступно событие «TextChanged». Событие наступает при каждом изменении данных в Текстовом поле пользователем. Для опроса нового текста необходимо использовать параметр «newText» данного события.