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>
<Change User="" Source="" ValueSet="" />
<!--Тэги, специфичные для CheckedComboBox-->
<DropDownHeight></DropDownHeight>
<DropDownWidth></DropDownWidth>
<InputLanguage></InputLanguage>
<InputCase></InputCase>
<SearchMode Value="" />
<NullValue Show="" Title="" />
<NullValueTitle></NullValueTitle>
<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
Значением <CheckedComboBox> считается линейный массив выбранных элементов из списка.
<Object Name="CheckedComboBoxName" />Задание значения CheckedComboBox
Значение объекта: любое значение (кроме 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
Признак, определяющий, может ли пользователь искать элементы в списке с помощью ручного ввода текста.
Необязательный тэг. Значение тэга <SearchMode>: не ожидается.
Если тэг <SearchMode> отсутствует, то для атрибута Value используется значение True.
<SearchMode Value="True" />Атрибуты тэга <SearchMode>
Value
Значение.
Обязательный атрибут. Ожидается логическое значение.
NullValue
Настройка отображения NULL-значения объекта.
Необязательный тэг. Значение тэга <NullValue>: не ожидается.
Если тэг <NullValue> отсутствует, то для атрибута Show используется значение False.
<NullValue Show="False" Title="[Все]" />Атрибуты тэга <NullValue>
Show
Признак, определяющий, будет ли объект иметь значение NULL в том случае, если были отмечены все значения из выпадающего списка.
Необязательный атрибут. Ожидается логическое значение.
Если атрибут Show отсутствует, то используется значение False.
Значение True так же означает, что в список элементов на первую позицию будет добавлен элемент "[Все]", по нажатию на который будут отмечены все остальные элементы в списке.
Title
Отображаемое значение элемента, по нажатию на который будут отмечены все остальные элементы в списке.
Необязательный атрибут. Любое значение будет переведено в текстовое.
Если атрибут Title отсутствует, то используется пустое значение.
NullValueTitle
Отображаемое значение элемента, по нажатию на который будут отмечены все остальные элементы в списке.
Необязательный тэг. Любое значение будет переведено в текстовое.
Если тэг <NullValueTitle> отсутствует, то используется пустое значение.
Игнорируется при наличии атрибута Title в тэге <NullValue>.
<NullValueTitle>[Все]</NullValueTitle>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>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>ValueList
Задает элементы выпадающего списка.
Ожидается таблица с двумя столбцами (например, ссылка на GetDataConnection с указанием двух его полей).
<Object Name="CheckedComboBoxName">
<Property Name="ValueList">
<DataConnection SourceDataConnection="SourceDataConnectionName">
<Fields>
<Field Name="Field1Name" />
<Field Name="Field2Name" />
</Fields>
</DataConnection>
</Property>
</Object>Last updated