ListBox

Графический объект; список.

Шаблон ListBox

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

<MyObject Name="" Type="ListBox" 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="" />
  <!--Тэги, специфичные для ListBox-->
  <Sorted></Sorted>
  <SelectionMode></SelectionMode>
  <NullValue Show="" Title="" />
  <ValueList>
    <DataConnection SourceDataConnection="">
      <Fields>
        <Field Name="" />
        <Field Name="" />
      </Fields>
    </DataConnection>
  </ValueList>
  <Value></Value>
</MyObject>

Описание ListBox

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

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

Значением ListBox считается реальное (не отображаемое, а именно реальное) значение выбранного элемента из списка.

<Object Name="ListBoxName" />

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

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

<Object Name="ListBoxName"></Object>

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

Sorted

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

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

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

<Sorted>False</Sorted>

SelectionMode

Название типа выбора элементов в списке.

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

None	Выделение элементов запрещено
One	Разрешено выделение только одного элемента

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

<SelectionMode>One</SelectionMode>

NullValue

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

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

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

<NullValue Show="" Title="" />

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

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

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

SelectionMode

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

<Object Name="ListBoxName">
  <Property Name="SelectionMode" />
</Object>

Text

Возвращает отображаемое значение выбранного элемента.

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

ValueList

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

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

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

Sorted

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

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

<Object Name="ListBoxName">
  <Property Name="Sorted">True</Property>
</Object>

SelectionMode

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

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

<Object Name="ListBoxName">
  <Property Name="SelectionMode">MultiExtended</Property>
</Object>

ValueList

Задает элементы списка.

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

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