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>
<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>
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>
<BackColor>
Name
Значение.
Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
Тэг <Expression>
<Expression>
Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет.
Обязательный тэг. Значение тэга <Expression>
: любое значение.
Выражение для вычисления поддерживает переменные вида "[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные).
Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д.
Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке https://ncalc.codeplex.com/wikipage?title=functions.
Тэг <Items>
<Items>
Переменные для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Items>
: список тэгов <Item>
.
Тэг <Item>
<Item>
Переменная для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Item>
: любое значение.
Тэг <ForeColor>
<ForeColor>
Используется в тэге <Formatting>
.
Условный цвет шрифта элемента списка.
Необязательный тэг. Значение тэга <ForeColor>
: не ожидается.
Атрибуты тэга <ForeColor>
<ForeColor>
Name
Значение.
Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
Тэг <Expression>
<Expression>
Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет.
Обязательный тэг. Значение тэга <Expression>
: любое значение.
Выражение для вычисления поддерживает переменные вида "[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные).
Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д.
Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке https://ncalc.codeplex.com/wikipage?title=functions.
Тэг <Items>
<Items>
Переменные для подстановки в выражение для вычисления.
Необязательный тэг. Значение тэга <Items>
: список тэгов <Item>
.
Тэг <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>
Last updated