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>
  <Opacity></Opacity>
  <Hint></Hint>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для ComboBox-->
  <Sorted></Sorted>
  <NullValue Show="" Title="" />
  <NullValueTitle></NullValueTitle>
  <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 считается реальное значение выбранного элемента из списка.

<Object Name="ComboBoxName" />

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

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

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

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

Sorted

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

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

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

<Sorted>False</Sorted>

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>

ValueList

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

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

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

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

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

Value

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

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

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

<Value>Value</Value>

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

Sorted

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

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

Text

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

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

VisibleText

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

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

Percentage

Возвращает значение в процентах от отображаемого значения поля (например, при отображаемом значении "0,95" проперти Percentage вернет 95).

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

Length

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

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

ValueList

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

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

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

Sorted

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

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

<Object Name="ComboBoxName">
  <Property Name="Sorted">True</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>