TextBox
Поле для ввода и редактирования текста. Элемент пользовательского интерфейса.
Шаблон TextBox
Перечень всех возможных тэгов объекта:
<MyObject Name="" Type="TextBox" Assembly="BaseControls" ChangeForm="">
<!--Тэги, общие для всех графических объектов-->
<Top></Top>
<Bottom></Bottom>
<Left></Left>
<Right></Right>
<Height></Height>
<Width></Width>
<FontStyle></FontStyle>
<ForeColor></ForeColor>
<BackColor></BackColor>
<Enabled></Enabled>
<Visible></Visible>
<Hint></Hint>
<ContextMenu Name="" />
<Change User="" Source="" ValueSet="" />
<!--Тэги, специфичные для TextBox-->
<MaxLength></MaxLength>
<ReadOnly></ReadOnly>
<Multiline></Multiline>
<Password></Password>
<ShowPasswordButton></ShowPasswordButton>
<AllowedSymbols></AllowedSymbols>
<InputLanguage></InputLanguage>
<InputCase></InputCase>
<SelectOnEnter></SelectOnEnter>
<Mask></Mask>
<TipText></TipText>
<TextAlign></TextAlign>
<Text></Text>
<ScrollBars></ScrollBars>
</MyObject>Описание TextBox
Значением TextBox считается текст, указанный в поле.
Получение значения
Для получения указанного в поле текста используется get-проперти Text:
Рекомендуется использовать сокращенный вариант записи:
Задание значения
Для задания значения текстовому полю используется set-проперти Text:
Рекомендуется использовать сокращенный вариант записи:
Тэги, специфичные для TextBox
MaxLength
Задает максимальное число символов, которое разрешается вводить или вставлять в текстовое поле.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 0, показывающее, что ограничения нет.
ReadOnly
Указывает, доступно ли текстовое поле только для чтения или для чтения и редактирования.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
Multiline
Задает значение, показывающее, является ли данный элемент управления многострочным текстовым полем.
Игнорируется при наличии тэга <Mask>.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
Password
Признак, разрешающий ввод пароля.
Пользователь увидит только символы звездочек ( * ). Игнорируется при наличии тэга <Mask>.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
ShowPasswordButton
Признак, определяющий, будет ли показана кнопка просмотра введенных символов.
Игнорируется, если тэг <Password> отсутствует.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
Если в тэге <Password> явно задано значение False, а в тэге <ShowPasswordButton> стоит значение True, то текстовое поле будет работать в режиме ввода пароля с отображением введенных символов.
AllowedSymbols
Задает набор символов, которые разрешено вводить в поле. Пустая строка соответствует запрету вводить вообще какие-либо символы.
Необязательный тэг. Любое значение будет переведено в текстовое.
Если тэг отсутствует, то можно вводить любые символы.
InputLanguage
Задает ограничение на язык вводимых символов. Если язык вводимого символа не совпадает с языком, указанным в данном тэге, то этот символ будет трансформирован в символ другого языка, расположенный на этой же клавише клавиатуры.
Необязательный тэг. Ожидается одно из допустимых значений:
Rus
Русский язык
Eng
Английский язык
None
Без ограничений по языку
По умолчанию используется значение None.
Например, при значении Rus вводимая последовательность символов "qwerty" будет преобразована в "йцукен".
InputCase
Задает ограничение на регистр вводимых символов. Если регистр вводимого символа не совпадает с регистром, указанном в данном тэге, то этот символ будет трансформирован в указанный регистр.
Необязательный тэг. Ожидается одно из допустимых значений:
Upper
Верхний регистр
Lower
Нижний регистр
None
Без ограничений по регистру
По умолчанию используется значение None.
SelectOnEnter
Признак, определяющий, будет ли выделено содержимое поля после получения им фокуса.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
Mask
Маска ввода текстового поля.
При наличии тэга <Mask> поля <Multiline>, <Password> и <TextAlign> объекта игнорируются.
Если тэг <Mask> отсутствует, то маска ввода не используется и не сможет в дальнейшем быть установлена.
Пустая строка соответствует отсутствию маски, при этом поля <Multiline>, <Password> и <TextAlign> объекта по-прежнему игнорируются.
Необязательный тэг. Любое значение будет переведено в текстовое.
Все поддерживаемые элементы в выражении для задания маски ввода смотрите по ссылке.
Для задания маски номера телефона используется служебное слово PHONE, которое переключает текстовое поле в режим ввода номера телефона. При этом маска выбирается автоматически на основе зоны и кода страны. Подробнее по ссылкам здесь и здесь.
TipText
Задает текст-заполнитель, который будет отображаться в поле, если оно не имеет фокуса и его значение NULL.
Необязательный тэг. Любое значение будет переведено в текстовое.
TextAlign
Используется, чтобы указать способ выравнивания текста по горизонтали.
Игнорируется при наличии тэга <Mask>.
Необязательный тэг. Ожидается одно из допустимых значений:
Left
Слева
Center
По центру
Right
Справа
По умолчанию используется значение Left.
Text
Задает значение текстового поля.
Необязательный тэг. Любое значение будет переведено в текстовое.
По умолчанию используется пустая строка.
ScrollBars
Тип полос прокрутки, показывающий, какие полосы прокрутки должны присутствовать в многострочном поле.
Используется при установленном тэге <Multiline>.
Необязательный тэг. Ожидается одно из допустимых значений:
Vertical
Вертикальная полоса прокрутки
Horizontal
Горизонтальная полоса прокрутки
Both
Вертикальная и горизонтальная полосы прокрутки
None
Без полос прокрутки
По умолчанию используется значение Vertical.
BorderStyle
Задает тип границы элемента.
Необязательный тэг. Ожидается одно из допустимых значений:
FixedSingle
Одиночная плоская граница
Fixed3D
Одиночная объемная граница
None
Нет границы
По умолчанию используется значение FixedSingle.
Get-проперти для получения свойств
MaxLength
Возвращает максимальное число символов, которое разрешается вводить или вставлять в текстовое поле.
ReadOnly
Возвращает значение, определяющее, доступно ли текстовое поле только для чтения или для чтения и редактирования.
Multiline
Возвращает значение, показывающее, является ли данный элемент управления многострочным текстовым полем.
Password
Возвращает значение признака ввода пароля в поле.
AllowedSymbols
Возвращает набор символов, которые разрешено вводить в поле.
InputLanguage
Возвращает название языка, к которому будут преобразовываться вводимые символы.
InputCase
Возвращает название регистра, к которому будут преобразовываться вводимые символы.
SelectOnEnter
Возвращает значение признака, определяющего, будет ли выделено содержимое поля после получения им фокуса.
Mask
Возвращает маску ввода текстового поля.
TipText
Возвращает текст-заполнитель, который будет отображаться в поле, если оно не имеет фокуса и его значение NULL.
TextAlign
Возвращает способ выравнивания текста по горизонтали.
Text
Возвращает значение текстового поля.
MaskCompleted
Возвращает значение, показывающее, все ли обязательные входные данные введены в маску ввода.
Пример
Если у текстового поля задана маска вида:
0 - обязательный символ, принимает любую цифру от 0 до 9;
\# - необязательный символ, принимает любую цифру от 0 до 9 или пробел. Допускаются знаки плюс (+) и минус (-);
? - необязательный символ, принимает буквы таблицы ASCII.
Если в поле будут введены все обязательные цифры, то get-проперти MaskCompleted вернет значение true. Если будет отсутствовать хотя бы одна обязательная цифра, то будет возвращено значение false.
MaskFull
Возвращает значение, показывающее, все ли обязательные и необязательные входные данные были введены в маску ввода.
Пример
Если у текстового поля задана маска вида:
Если в поле будет введена строка вида "1234-A", то get-проперти MaskFull вернет значение true. Если будет отсутствовать хотя бы один любой символ, то будет возвращено значение false.
WordByNumber
Возвращает целое слово с указанным порядковым номером, извлеченное из значения поля. Символами-разделителями между словами считаются " ", ",", ".", ";".
Ожидается целочисленное положительное значение.
Например, для строки "слово1 слово2" свойство со значением 2 вернет "слово2".
Length
Возвращает длину текста, введенного в поле.
ScrollBars
Возвращает тип полос прокрутки, показывающий, какие полосы прокрутки должны присутствовать в многострочном поле.
BorderStyle
Возвращает тип границы элемента.
Set-проперти для динамического задания свойств
MaxLength
Задает максимальное число символов, которое разрешается вводить или вставлять в текстовое поле.
Ожидается положительное целочисленное значение.
ReadOnly
Задает значение, определяющее, доступно ли поле только для чтения или для чтения и редактирования.
Ожидается логическое значение.
Multiline
Задает значение, показывающее, является ли данный элемент управления многострочным текстовым полем.
Если тэг <Mask> присутствует в описании объекта, то любое переданное значение игнорируется.
Ожидается логическое значение.
Password
Задает значение признака ввода пароля в поле.
Если тэг <Mask> присутствует в описании объекта, то любое переданное значение игнорируется.
Ожидается логическое значение.
AllowedSymbols
Задает набор символов, которые разрешено вводить в поле.
Любое значение будет переведено в текстовое.
InputLanguage
Задает правила трансформации языка вводимых символов.
Ожидается одно из допустимых значений, указанных в описании тэга <InputLanguage>.
InputCase
Задает название языка, к которому будут преобразовываться вводимые символы.
Ожидается одно из допустимых значений, указанных в описании тэга <InputCase>.
SelectOnEnter
Задает значение признака, определяющего, будет ли выделено содержимое поля после получения им фокуса.
Ожидается логическое значение.
Mask
Задает маску ввода текстового поля.
Если тэг <Mask> отсутствует в описании объекта, то маска не будет установлена.
Любое значение будет переведено в текстовое. Полные правила указания маски ввода указаны в описании тэга <Mask>.
TipText
Задает текст-заполнитель, который будет отображаться в поле, если оно не имеет фокуса и его значение NULL.
Любое значение будет переведено в текстовое.
TextAlign
Задает способ выравнивания текста по горизонтали.
Если тэг <Mask> присутствует в описании объекта, то любое переданное значение игнорируется.
Ожидается одно из допустимых значений, указанных в описании тэга <TextAlign>.
Text
Задает значение текстового поля.
Любое значение будет переведено в текстовое.
AppendText
Дописывает поле заданным текстом и переводит курсор в конец поля.
Любое значение будет переведено в текстовое.
InsertAtCursorPosition
Вставляет заданный текст на место курсора и после переводит курсор в конец добавленного текста. Если поле не содержит фокуса, то тогда вставляемый текст добавляется в конец строки, и поле получает фокус.
Любое значение будет переведено в текстовое.
ScrollBars
Задает тип полос прокрутки, показывающий, какие полосы прокрутки должны присутствовать в многострочном поле.
Используется при установленном тэге <Multiline>.
Ожидается одно из допустимых значений, указанных в описании тэга <ScrollBars>.
ScrollToEnd
Прокручивает содержимое поля до вертикальных и горизонтальных конечных точек полос прокрутки.
Значение не ожидается.
BorderStyle
Задает тип границы элемента.
Ожидается одно из допустимых значений, указанных в описании тэга <BorderStyle>.
Last updated