Поле с форматированием
Поле с форматированием является компонентом, позволяющим изменить одну строку текста и поддерживающим произвольное форматирование. |
|
Поле с форматированием выглядит следующим образом:
Общие свойства
Ширина, Высота, Привязки, Активный, Видимый, Основной цвет, Фон, Непрозрачный, Рамка, Шрифт, Всплывающая подсказка, Фокусируемый, Всплывающее меню
Пользовательские свойства
Текст
Текст по умолчанию в текстовом поле.
Имя свойства: text
Тип свойства: String
Редактируемый
Флажок указывает на то, что текст в поле может быть изменен. Основное различие между нередактируемыми и невключенными компонентами представляет тот факт, что текст в нередактируемом компоненте остается доступным и может быть выбран при помощи мыши.
Экранная клавиатура
Определяет, должен ли компонент поддерживать экранную клавиатуру для ввода текста. Для получения более подробной информации см. поддержку сенсорного экрана.
Возможные варианты:
- Отсутствует - не использует экранную клавиатуру
- Один щелчок - отображает клавиатуру при щелчке на любой области компонента
- Двойной щелчок - отображает клавиатуру, если на компоненте щелкнуть два раза
Имя свойства: onscreenKeyboard
Тип свойства: Integer
Выравнивание
Горизонтальное выравнивание текста в компоненте.
Возможные значения:
Описание | Значение |
Слева | 2 |
По центру | 0 |
Справа | 4 |
Имя свойства: horizontalAlignment
Тип свойства: Integer
Режим валидации
Выбирает регулярное выражение или валидацию поля маски.
Возможные значения:
Описание | Значение |
Маска | 0 |
Регулярное выражение | 1 |
Имя свойства: validationMode
Тип свойства: Integer
 | Маска, Валидные символы, Невалидные символы, Символ-заполнитель и Заполнитель включаются только тогда, когда режим форматирования равен Маске. Регулярное выражение включается только тогда, когда Режим валидации равен Регулярному выражению. |
Маска
Шаблон валидации маски. Данный параметр определяет набор символов для ввода в каждой позиции поля.
Могут быть определены следующие символы:
Символ | Описание |
# | Любое число. |
' | Символ используется для выделения любого из специальных символов форматирования |
U | Любой символ. Все символы нижнего регистра преобразовываются в символы верхнего регистра. |
L | Любой символ. Все символы верхнего регистра преобразовываются в символы нижнего регистра. |
A | Любой символ или число. |
? | Любой символ. |
* | Символ или число. |
H | Любой шестнадцатиричный символ (0-9, a-f или A-F) |
| Свойство Маска работает вместе со свойствами Валидные символы и Невалидные символы (см. далее):
|
Имя свойства: mask
Тип свойства: String
Валидные символы
Список валидных символов в любой позиции строки. Таким образом, если значение свойства Валидные символы ненулевое, символ будет считаться валидным, если он есть внутри строки валидных символов и соответствует маске.
Имя свойства: validCharacters
Тип свойства: String
Невалидные символы
Список символов, которые будут невалидными в любой позиции строки, независимо от Маски.
Имя свойства: invalidCharacters
Тип свойства: String
Заполнитель
Используемая строка, если значение не полностью заполняет строку. Значение NULL подразумевает использование символа-заполнителя. Приоритет отдается строке заполнителя.
Введеная строка будет использоваться в исходном формате, после будет использоваться только символ-заполнитель.
Имя свойства: placeholder
Тип свойства: String
Символ-заполнитель
Символ, используемый вместо отсутствующих в значении, т.е. пользователь должен их ввести. Значением по умолчанию является пробел.
Это применимо только тогда, когда строка Заполнитель не была задана или не полностью заполняет маску.
Имя свойства: placeholderCharacter
Тип свойства: String
Регулярное выражение
Шаблон регулярного выражения, используемый для валидации значения, если Режим валидации установлен на "Регулярное выражение".
Имя свойства: regEx
Тип свойства: String
Перезаписывать текст
Настраивает поведение при вводе символов. Если данный параметр является true, новые символы записываются поверх существующих символов в поле.
Имя свойства: overwritesText
Тип свойства: Boolean
Поведение при потере фокуса
Следит за тем, что происходит, когда поле форматируемого текста теряет фокус.
Описание | Значение | Примечание |
Сохранить | 0 | Фиксирует значение. Если отредактированное значение не является допустимым, тогда значение компонента не изменяется, а отредактированное значение не заменяет значение компонента. |
Сохранить или Восстановить | 1 | Похоже на Сохранить, но если значение недопустимо, поведение такое же, как при Восстановить. |
Восстановить | 2 | Возвращает дисплей к заданному по умолчанию, возможно, с потерей текущего редактирования. |
Удержать | 3 | Не предпринимает никаких действий, т.е. не обновляет значение. |
Имя свойства: focusLostBehaviour
Тип свойства: Boolean
Общие события
Скрытие, Показ, Перемещение, Изменение размеров, Клик мыши, Нажатие кнопки мыши, Отпускание кнопки мыши, Вход мыши, Выход мыши, Перемещение мыши, Вращение колесика мыши, Печать клавиши, Нажатие клавиши, Отпускание клавиши, Получение фокуса, Потеря фокуса
Пользовательские события
Обновление вставки
Это событие формируется каждый раз, когда вставка перемещается или в компонент вводится любой текст.
Имя события: caretUpdate
Поля события:
Поле | Имя | Тип | Описание |
идентификатор | id | целое | Идентификатор типа события. |
точка | dot | целое | Положение вставки. |
отметка | mark | целое | Положение другого конца логического отбора. Если отбора нет, оно будет таким же, как точка. |