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>
  <Hint></Hint>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для ListBox-->
  <Sorted></Sorted>
  <SelectionMode></SelectionMode>
  <NullValue Show="" Title="" />
  <Formatting>
    <BackColor Name="">
      <Expression></Expression>
      <Items>
        <Item></Item>
        <Item></Item>
      </Items>
    </BackColor>
    <ForeColor Name="">
      <Expression></Expression>
      <Items>
        <Item></Item>
        <Item></Item>
      </Items>
    </ForeColor>
  </Formatting>
  <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 считается реальное (не отображаемое, а именно реальное) значение выбранного элемента из списка.

<Object Name="ListBoxName" />

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

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

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

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

Sorted

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

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

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

<Sorted>False</Sorted>

SelectionMode

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

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

None	Выделение элементов запрещено
One	Разрешено выделение только одного элемента
MultiSimple	Разрешено выделение нескольких элементов
MultiExtended	Разрешено выделение нескольких элементов, и пользователь может производить выделение с помощью клавиши SHIFT, клавиши CTRL и клавиш со стрелками

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

<SelectionMode>One</SelectionMode>

NullValue

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

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

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

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

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

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

Formatting

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

Необязательный тэг. Значение тэга <Formatting>: список тэгов <BackColor> и <ForeColor>.

<Formatting>
  <BackColor Name="BackColor">
    <Expression>[0] > {0} * {1}</Expression>
    <Items>
      <Item>10</Item>
      <Item>20</Item>
    </Items>
  </BackColor>
  <ForeColor Name="ForeColor">
    <Expression>[0] > {0} * {1}</Expression>
    <Items>
      <Item>10</Item>
      <Item>20</Item>
    </Items>
  </ForeColor>
</Formatting>

Тэг <BackColor>

Используется в тэге <Formatting>.

Условный цвет фона элемента списка.

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

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

Name	Значение. Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).

Тэг <Expression>

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

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

Выражение для вычисления поддерживает переменные вида "[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные).

Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д.

Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке https://ncalc.codeplex.com/wikipage?title=functions.

Тэг <Items>

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

Необязательный тэг. Значение тэга <Items>: список тэгов <Item>.

Тэг <Item>

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

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

Тэг <ForeColor>

Используется в тэге <Formatting>.

Условный цвет шрифта элемента списка.

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

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

Name	Значение. Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).

Тэг <Expression>

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

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

Выражение для вычисления поддерживает переменные вида "[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные).

Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д.

Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке https://ncalc.codeplex.com/wikipage?title=functions.

Тэг <Items>

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

Необязательный тэг. Значение тэга <Items>: список тэгов <Item>.

Тэг <Item>

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

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

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>