ComboBox

Графический объект; поле с выпадающим списком.

Шаблон ComboBox

Перечень всех возможных тэгов объекта:

<MyObject Name="" Type="ComboBox" 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="" />
  <!--Тэги, специфичные для ComboBox-->
  <EnterText></EnterText>
  <MaxLength></MaxLength>
  <DropDownHeight></DropDownHeight>
  <DropDownWidth></DropDownWidth>
  <InputLanguage></InputLanguage>
  <InputCase></InputCase>
  <NullValue Show="" Title="" />
  <NullValueTitle></NullValueTitle>
  <AllowOutOfList Value="" />
  <Text></Text>
  <ValueList>
    <DataConnection SourceDataConnection="">
      <Fields>
        <Field Name="" />
        <Field Name="" />
      </Fields>
    </DataConnection>
  </ValueList>
  <Value></Value>
</MyObject>

Описание ComboBox

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

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

Значением ComboBox считается реальное значение выбранного элемента из списка.

<Object Name="ComboBoxName" />

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

Значение объекта: любое значение.

<Object Name="ComboBoxName"></Object>

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

EnterText

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

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

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

<EnterText>False</EnterText>

MaxLength

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

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

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

<MaxLength>0</MaxLength>

DropDownHeight

Высота выпадающего списка.

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

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

<DropDownHeight>100</DropDownHeight>

DropDownWidth

Ширина выпадающего списка.

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

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

<DropDownWidth>200</DropDownWidth>

InputLanguage

Название языка для ограничения по вводимым символам.

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

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

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

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

<InputLanguage>None</InputLanguage>

InputCase

Название типа регистра для ограничения по вводимым символам.

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

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

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

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

<InputCase>None</InputCase>

Text

Текст поля (доступно в случае, если <EnterText> имеет значение True).

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

Текстовое значение может быть присвоено, только если основное значение <Value> равно NULL.

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

NullValue

Настройка отображения NULL-значения объекта.

Необязательный тэг. Значение тэга <NullValue>: не ожидается.

Если тэг <NullValue> отсутствует, то для атрибута Show используется значение False.

<NullValue Show="False" Title="[не выбрано]" />

Атрибуты тэга <NullValue>

Show	Признак, определяющий, будет ли в выпадающем списке элемент, имеющий реальное значение NULL. Необязательный атрибут. Ожидается логическое значение. По умолчанию используется значение False.
Title	Отображаемое значение элемента, имеющего реальное значение NULL. Необязательный атрибут. Любое значение будет переведено в текстовое. По умолчанию используется пустое значение.

NullValueTitle

Отображаемое значение элемента, имеющего реальное значение NULL.

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

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

Игнорируется при наличии атрибута Title в тэге <NullValue>.

<NullValueTitle>[не выбрано]</NullValueTitle>

AllowOutOfList

Признак, разрешающий полю принимать и хранить значение даже если это значение отсутствует в списке элементов поля.

Необязательный тэг. Значение тэга <AllowOutOfList>: не ожидается.

Если тэг <AllowOutOfList> отсутствует, то для атрибута Value используется значение False.

<AllowOutOfList Value="False" />

Атрибуты тэга <AllowOutOfList>

Value	Значение. Обязательный атрибут. Ожидается логическое значение.

ValueList

Элементы выпадающего списка.

Необязательный тэг. Ожидается таблица с одним, двумя или более столбцами (например, ссылка на GetDataConnection).

Первое поле будет соответствовать реальному значению элемента, второе – его отображаемому значению (если второго поля нет, то отображаемое значение равно реальному).

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

<ValueList>
  <DataConnection SourceDataConnection="SourceDataConnectionName">
    <Fields>
      <Field Name="Field1Name" />
      <Field Name="Field2Name" />
    </Fields>
  </DataConnection>
</ValueList>

Value

Значение, соответствующее реальному значению выбранного элемента.

Необязательный тэг. Значение тэга <Value>: любое значение.

Если введенное в поле текстовое значение совпадает по отображаемому значению с одним из элементов выпадающего списка, то значение объекта равно реальному значению соответствующего элемента выпадающего списка, иначе - введенному в поле значению.

<Value>Value</Value>

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

EnterText

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

<Object Name="ComboBoxName">
  <Property Name="EnterText" />
</Object>

MaxLength

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

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

DropDownHeight

Возвращает высоту выпадающего списка.

<Object Name="ComboBoxName">
  <Property Name="DropDownHeight" />
</Object>

DropDownWidth

Возвращает ширину выпадающего списка.

<Object Name="ComboBoxName">
  <Property Name="DropDownWidth" />
</Object>

InputLanguage

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

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

InputCase

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

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

Text

Возвращает отображаемое значение поля только в том случае, если реальное значение <Value> возвращает NULL.

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

VisibleText

Возвращает отображаемое значение поля.

<Object Name="ComboBoxName">
  <Property Name="VisibleText" />
</Object>

ValueList

Возвращает элементы выпадающего списка (таблица с двумя столбцами).

<Object Name="ComboBoxName">
  <Property Name="ValueList" />
</Object>

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

EnterText

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

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

<Object Name="ComboBoxName">
  <Property Name="EnterText">True</Property>
</Object>

MaxLength

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

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

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

DropDownHeight

Задает высоту выпадающего списка.

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

<Object Name="ComboBoxName">
  <Property Name="DropDownHeight">400</Property>
</Object>

DropDownWidth

Задает ширину выпадающего списка.

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

<Object Name="ComboBoxName">
  <Property Name="DropDownWidth">300</Property>
</Object>

InputLanguage

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

Ожидается один из языков.

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

InputCase

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

Ожидается один из типов регистров.

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

Text

Задает отображаемое значение поля.

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

Текстовое значение может быть присвоено только если основное значение <Value> равно NULL.

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

ValueList

Задает элементы выпадающего списка.

Ожидается таблица с двумя столбцами (например, ссылка на GetDataConnection с указанием двух его полей).

<Object Name="ComboBoxName">
  <Property Name="ValueList">
    <DataConnection SourceDataConnection="SourceDataConnectionName">
      <Fields>
        <Field Name="Field1Name" />
        <Field Name="Field2Name" />
      </Fields>
    </DataConnection>
  </Property>
</Object>