CheckedComboBox

Графический объект; поле с выпадающим списком и возможностью одновременного выбора нескольких элементов.

Шаблон CheckedComboBox

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

<MyObject Name="" Type="CheckedComboBox" 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="" />
  <!--Тэги, специфичные для CheckedComboBox-->
  <DropDownHeight></DropDownHeight>
  <DropDownWidth></DropDownWidth>
  <ScrollWithWheel></ScrollWithWheel>
  <InputLanguage></InputLanguage>
  <InputCase></InputCase>
  <SearchMode Value="" />
  <Sorted></Sorted>
  <UpdateResult Type="" />
  <FlatStyle></FlatStyle>
  <NullValue Show="" Title="" />
  <NullValueTitle></NullValueTitle>
  <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>

Описание CheckedComboBox

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

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

Значением <CheckedComboBox> считается линейный массив выбранных элементов из списка.

<Object Name="CheckedComboBoxName" />

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

Значение объекта: любое значение (кроме NULL) будет преобразовано в линейный массив.

<Object Name="CheckedComboBoxName"></Object>

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

DropDownHeight

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

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

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

<DropDownHeight>100</DropDownHeight>

DropDownWidth

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

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

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

<DropDownWidth>200</DropDownWidth>

ScrollWithWheel

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

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

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

<ScrollWithWheel>False</ScrollWithWheel>

InputLanguage

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

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

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

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

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

<InputLanguage>None</InputLanguage>

InputCase

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

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

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

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

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

<InputCase>None</InputCase>

SearchMode

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

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

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

<SearchMode Value="True" />

Search

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

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

VisibleChecked	только видимые элементы, которые автоматически отмечаются выбранными
Checked	все выделенные элементы

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

<Search Type="VisibleChecked"/>

Sorted

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

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

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

<Sorted>False</Sorted>

UpdateResult

Способ изменения значения объекта.

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

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

<UpdateResult Type="OnHide" />

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

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

Типы изменения значения объекта

OnHide	Изменение значения объекта происходит только после закрытия выпадающего списка.
Always	Изменение значения объекта происходит мгновенно при любом изменении выбора хотя бы одного элемента из выпадающего списка, даже без его закрытия.

FlatStyle

Название типа границ поля.

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

Flat	Плоское
Popup	Плоское, пока не наведена мышь
Standard	Обычное
System	Определяется операционной системой

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

<FlatStyle>Standard</FlatStyle>

NullValue

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

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

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

<NullValue Show="False" Title="[Все]" />

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

Show

Признак, определяющий, будет ли объект иметь значение NULL в том случае, если были отмечены все значения из выпадающего списка. Необязательный атрибут. Ожидается логическое значение. Если атрибут Show отсутствует, то используется значение False. Значение True так же означает, что в список элементов на первую позицию будет добавлен элемент "[Все]", по нажатию на который будут отмечены все остальные элементы в списке.

Title

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

NullValueTitle

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

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

Если тэг <NullValueTitle> отсутствует, то используется пустое значение.

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

<NullValueTitle>[Все]</NullValueTitle>

Formatting

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

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

<Formatting>
  <BackColor Name="BackColorName">
    <Expression>[0] > {0} * {1}</Expression>
    <Items>
      <Item>10</Item>
      <Item>20</Item>
    </Items>
  </BackColor>
  <ForeColor Name="ForeColorName">
    <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

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

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

Если поле имеет значение NULL, то элементы в выпадающем списке будут отмечены в зависимости от значения атрибута Show тэга <NullValue>. Если атрибут Show равен True, то будут отмечены все элементы в списке, иначе - не будет выбран ни один.

<Value>Value</Value>

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

DropDownHeight

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

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

DropDownWidth

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

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

InputLanguage

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

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

InputCase

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

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

Sorted

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

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

FlatStyle

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

<Object Name="CheckedComboBoxName">
  <Property Name="FlatStyle" />
</Object>

ValueList

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

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

ItemsCount

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

<Object Name="CheckedComboBoxName">
  <Property Name="ItemsCount" />
</Object>

SelectedItemsCount

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

<Object Name="CheckedComboBoxName">
  <Property Name="SelectedItemsCount" />
</Object>

VisibleText

Возвращает отображаемое значение поля, текстовый список выбранных элементов.

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

VisibleTextDelimeter

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

<Object Name="CheckedComboBoxName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="VisibleTextDelimeter" >
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Delimeter: ожидается символ или строка, которая будет использоваться как разделитель в выводимом списке выбранных элементов-->
      <Parameter Name="Delimeter">\r</Parameter>
    </Parameters>
  </Property>
</Object>

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

DropDownHeight

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

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

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

DropDownWidth

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

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

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

InputLanguage

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

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

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

InputCase

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

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

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

Sorted

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

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

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

FlatStyle

Задает название типа границ поля.

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

<Object Name="CheckedComboBoxName">
  <Property Name="FlatStyle">Popup</Property>
</Object>

ValueList

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

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

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