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>
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для TextBox-->
  <MaxLength></MaxLength>
  <ReadOnly></ReadOnly>
  <Multiline></Multiline>
  <Password></Password>
  <AllowedSymbols></AllowedSymbols>
  <InputLanguage></InputLanguage>
  <InputCase></InputCase>
  <SelectOnEnter></SelectOnEnter>
  <TipText></TipText>
  <TextAlign></TextAlign>
  <Text></Text>
  <ScrollBars></ScrollBars>  
</MyObject>

Описание TextBox

Значением TextBox считается текст, указанный в поле.

Получение значения TextBox

Для получения указанного в поле текста используется get-проперти Text:

Рекомендуется использовать сокращенный вариант записи:

Задание значения TextBox

Для задания значения текстовому полю используется set-проперти Text:

Рекомендуется использовать сокращенный вариант записи:

Тэги, специфичные для TextBox

MaxLength

Задает максимальное число символов, которое разрешается вводить или вставлять в текстовое поле.

Необязательный тэг. Ожидается положительное целочисленное значение.

По умолчанию используется значение 0, показывающее, что ограничения нет.

ReadOnly

Указывает, доступно ли текстовое поле только для чтения или для чтения и редактирования.

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение False.

Multiline

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

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение False.

Password

Признак, разрешающий ввод пароля. Пользователь увидит только символы звездочек ( * ). Игнорируется при наличии тэга <Multiline>.

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение False.

AllowedSymbols

Задает набор символов, которые разрешено вводить в поле. Пустая строка соответствует запрету вводить вообще какие-либо символы.

Необязательный тэг. Любое значение будет переведено в текстовое.

Если тэг отсутствует, то можно вводить любые символы.

InputLanguage

Задает ограничение на язык вводимых символов. Если язык вводимого символа не совпадает с языком, указанным в данном тэге, то этот символ будет трансформирован в символ другого языка, расположенный на этой же клавише клавиатуры.

Необязательный тэг. Ожидается одно из допустимых значений:

Rus

Русский язык

Eng

Английский язык

None

Без ограничений по языку

По умолчанию используется значение None.

Например, при значении Rus вводимая последовательность символов "qwerty" будет преобразована в "йцукен".

InputCase

Задает ограничение на регистр вводимых символов. Если регистр вводимого символа не совпадает с регистром, указанном в данном тэге, то этот символ будет трансформирован в указанный регистр.

Необязательный тэг. Ожидается одно из допустимых значений:

Upper

Верхний регистр

Lower

Нижний регистр

None

Без ограничений по регистру

По умолчанию используется значение None.

SelectOnEnter

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

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение False.

TipText

Задает текст-заполнитель, который будет отображаться в поле, если оно не имеет фокуса и его значение NULL.

Необязательный тэг. Любое значение будет переведено в текстовое.

TextAlign

Используется, чтобы указать способ выравнивания текста по горизонтали.

Необязательный тэг. Ожидается одно из допустимых значений:

Left

Слева

Center

По центру

Right

Справа

По умолчанию используется значение Left.

Text

Задает значение текстового поля.

Необязательный тэг. Любое значение будет переведено в текстовое.

По умолчанию используется пустая строка.

ScrollBars

Тип полос прокрутки, показывающий, какие полосы прокрутки должны присутствовать в многострочном поле. Используется при установленном тэге <Multiline>.

Необязательный тэг. Ожидается одно из допустимых значений:

Auto

Автоматические полосы прокрутки

Vertical

Вертикальная полоса прокрутки

Horizontal

Горизонтальная полоса прокрутки

Both

Вертикальная и горизонтальная полосы прокрутки

None

Без полос прокрутки

По умолчанию используется значение Auto.

Get-проперти для получения свойств

MaxLength

Возвращает максимальное число символов, которое разрешается вводить или вставлять в текстовое поле.

ReadOnly

Возвращает значение, определяющее, доступно ли текстовое поле только для чтения или для чтения и редактирования.

Multiline

Возвращает значение, показывающее, является ли данный элемент управления многострочным текстовым полем.

Password

Возвращает значение признака ввода пароля в поле.

AllowedSymbols

Возвращает набор символов, которые разрешено вводить в поле.

InputLanguage

Возвращает название языка, к которому будут преобразовываться вводимые символы.

InputCase

Возвращает название регистра, к которому будут преобразовываться вводимые символы.

SelectOnEnter

Возвращает значение признака, определяющего, будет ли выделено содержимое поля после получения им фокуса.

TipText

Возвращает текст-заполнитель, который будет отображаться в поле, если оно не имеет фокуса и его значение NULL.

TextAlign

Возвращает способ выравнивания текста по горизонтали.

Text

Возвращает значение текстового поля.

Length

Возвращает длину текста, введенного в поле.

ScrollBars

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

Set-проперти для динамического задания свойств

MaxLength

Задает максимальное число символов, которое разрешается вводить или вставлять в текстовое поле.

Ожидается положительное целочисленное значение.

ReadOnly

Задает значение, определяющее, доступно ли поле только для чтения или для чтения и редактирования.

Ожидается логическое значение.

Multiline

Задает значение, показывающее, является ли данный элемент управления многострочным текстовым полем. Если тэг <Mask> присутствует в описании объекта, то любое переданное значение игнорируется.

Ожидается логическое значение.

Password

Задает значение признака ввода пароля в поле. Если тэг <Mask> присутствует в описании объекта, то любое переданное значение игнорируется.

Ожидается логическое значение.

AllowedSymbols

Задает набор символов, которые разрешено вводить в поле.

Любое значение будет переведено в текстовое.

InputLanguage

Задает правила трансформации языка вводимых символов.

Ожидается одно из допустимых значений, указанных в описании тэга <InputLanguage>.

InputCase

Задает название языка, к которому будут преобразовываться вводимые символы.

Ожидается одно из допустимых значений, указанных в описании тэга <InputCase>.

SelectOnEnter

Задает значение признака, определяющего, будет ли выделено содержимое поля после получения им фокуса.

Ожидается логическое значение.

TipText

Задает текст-заполнитель, который будет отображаться в поле, если оно не имеет фокуса и его значение NULL.

Любое значение будет переведено в текстовое.

TextAlign

Задает способ выравнивания текста по горизонтали. Если тэг <Mask> присутствует в описании объекта, то любое переданное значение игнорируется.

Ожидается одно из допустимых значений, указанных в описании тэга <TextAlign>.

Text

Задает значение текстового поля.

Любое значение будет переведено в текстовое.

AppendText

Дописывает поле заданным текстом и переводит курсор в конец поля.

Любое значение будет переведено в текстовое.

ScrollBars

Задает тип полос прокрутки, показывающий, какие полосы прокрутки должны присутствовать в многострочном поле. Используется при установленном тэге <Multiline>.

Ожидается одно из допустимых значений, указанных в описании тэга <ScrollBars>.

Last updated