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

<MyObject Name="TextBoxName" Type="TextBox" Assembly="BaseControls">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для TextBox-->
</MyObject>

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

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

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

<Object Name="TextBoxName">
  <Property Name="Text" />
</Object>

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

<Object Name="TextBoxName" />

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

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

<Object Name="TextBoxName">
  <Property Name="Text">Текст</Property>
</Object>

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

<Object Name="TextBoxName">Текст</Object>

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

MaxLength

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

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

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

<MaxLength>0</MaxLength>

ReadOnly

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

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

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

<ReadOnly>False</ReadOnly>

Multiline

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

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

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

<Multiline>False</Multiline>

Password

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

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

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

<Password>False</Password>

AllowedSymbols

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

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

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

<AllowedSymbols>0123456789</AllowedSymbols>

InputLanguage

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

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

Rus	Русский язык
Eng	Английский язык
None	Без ограничений по языку

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

<InputLanguage>None</InputLanguage>

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

InputCase

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

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

Upper	Верхний регистр
Lower	Нижний регистр
None	Без ограничений по регистру

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

<InputCase>None</InputCase>

SelectOnEnter

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

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

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

<SelectOnEnter>False</SelectOnEnter>

TipText

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

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

<TipText>Текст подсказки</TipText>

TextAlign

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

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

Left	Слева
Center	По центру
Right	Справа

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

<TextAlign>Left</TextAlign>

Text

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

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

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

<Text>Текст</Text>

ScrollBars

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

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

Auto	Автоматические полосы прокрутки
Vertical	Вертикальная полоса прокрутки
Horizontal	Горизонтальная полоса прокрутки
Both	Вертикальная и горизонтальная полосы прокрутки
None	Без полос прокрутки

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

<ScrollBars>Vertical</ScrollBars>

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

MaxLength

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

<Object Name="TextBoxName">
  <Property Name="MaxLength" />
</Object>

ReadOnly

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

<Object Name="TextBoxName">
  <Property Name="ReadOnly" />
</Object>

Multiline

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

<Object Name="TextBoxName">
  <Property Name="Multiline" />
</Object>

Password

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

<Object Name="TextBoxName">
  <Property Name="Password" />
</Object>

AllowedSymbols

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

<Object Name="TextBoxName">
  <Property Name="AllowedSymbols" />
</Object>

InputLanguage

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

<Object Name="TextBoxName">
  <Property Name="InputLanguage" />
</Object>

InputCase

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

<Object Name="TextBoxName">
  <Property Name="InputCase" />
</Object>

SelectOnEnter

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

<Object Name="TextBoxName">
  <Property Name="SelectOnEnter" />
</Object>

TipText

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

<Object Name="TextBoxName">
  <Property Name="TipText" />
</Object>

TextAlign

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

<Object Name="TextBoxName">
  <Property Name="TextAlign" />
</Object>

Text

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

<Object Name="TextBoxName">
  <Property Name="Text" />
</Object>

Length

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

<Object Name="TextBoxName">
  <Property Name="Length" />
</Object>

ScrollBars

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

<Object Name="TextBoxName">
  <Property Name="ScrollBars" />
</Object>

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

MaxLength

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

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

<Object Name="TextBoxName">
  <Property Name="MaxLength">200</Property>
</Object>

ReadOnly

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

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

<Object Name="TextBoxName">
  <Property Name="ReadOnly">True</Property>
</Object>

Multiline

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

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

<Object Name="TextBoxName">
  <Property Name="Multiline">True</Property>
</Object>

Password

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

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

<Object Name="TextBoxName">
  <Property Name="Password">True</Property>
</Object>

AllowedSymbols

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

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

<Object Name="TextBoxName">
  <Property Name="AllowedSymbols">0123,.</Property>
</Object>

InputLanguage

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

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

<Object Name="TextBoxName">
  <Property Name="InputLanguage">Rus</Property>
</Object>

InputCase

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

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

<Object Name="TextBoxName">
  <Property Name="InputCase">Lower</Property>
</Object>

SelectOnEnter

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

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

<Object Name="TextBoxName">
  <Property Name="SelectOnEnter">True</Property>
</Object>

TipText

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

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

<Object Name="TextBoxName">
  <Property Name="TipText">Текст</Property>
</Object>

TextAlign

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

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

<Object Name="LabelName">
  <Property Name="TextAlign">Right</Property>
</Object>

Text

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

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

<Object Name="TextBoxName">
  <Property Name="Text">Текст</Property>
</Object>

AppendText

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

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

<Object Name="TextBoxName">
  <Property Name="AppendText">Текст</Property>
</Object>

ScrollBars

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

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

<Object Name="TextBoxName">
  <Property Name="ScrollBars">Horizontal</Property>
</Object>