# CheckedComboBox ## Шаблон CheckedComboBox Перечень всех возможных тэгов объекта: ```xml ``` ## Описание CheckedComboBox ```xml ``` ### Получение значения Значением `` считается линейный массив выбранных элементов из списка. ```xml ``` ### Задание значения Значение объекта: любое значение (кроме NULL) будет преобразовано в линейный массив. ```xml ``` ## Тэги, специфичные для CheckedComboBox ### DropDownHeight Высота выпадающего списка. Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется стандартное значение .NET. ```xml 100 ``` ### DropDownWidth Ширина выпадающего списка. Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется значение ширины объекта. ```xml 200 ``` ### ScrollWithWheel Признак, включающий или отключающий возможность изменять значение колесиком мышки. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение True. ```xml False ``` ### InputLanguage Название языка для ограничения по вводимым символам. Необязательный тэг. Ожидается название одного из языков:
RusРусский
EngАнглийский
NoneБез ограничений по языку
По умолчанию используется значение None. Если язык вводимого символа не совпадает с языком, указанном в данном тэге, то этот символ будет трансформирован в символ другого языка, расположенный на этой же клавише на клавиатуре. ```xml None ``` ### InputCase Название типа регистра для ограничения по вводимым символам. Необязательный тэг. Ожидается название одного из типов регистров:
UpperВерхний регистр
LowerНижний регистр
NoneБез ограничений по регистру
По умолчанию используется значение None. Если регистр вводимого символа не совпадает с регистром, указанном в данном тэге, то этот символ будет трансформирован в указанный регистр. ```xml None ``` ### SearchMode Признак, определяющий, может ли пользователь искать элементы в списке с помощью ручного ввода текста. Необязательный тэг. Обязательный атрибут `Value` ожидает логическое значение. По умолчанию используется значение True. ```xml ``` ### Search Признак, определяющий, тип поиска. Необязательный тэг. Для обязательного атрибута `Type` ожидается название одного из типов:
VisibleCheckedтолько видимые элементы, которые автоматически отмечаются выбранными
Checkedвсе выделенные элементы
По умолчанию используется значение VisibleChecked. ```xml ``` ### Sorted Признак сортировки элементов выпадающего списка по отображаемым значениям. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### UpdateResult Способ изменения значения объекта. Необязательный тэг. Значение тэга ``: не ожидается. Если тэг `` отсутствует, то для атрибута `Type` используется значение OnHide. ```xml ``` #### Атрибуты тэга \
Type

Название типа изменения значения объекта.

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

#### Типы изменения значения объекта
OnHideИзменение значения объекта происходит только после закрытия выпадающего списка.
AlwaysИзменение значения объекта происходит мгновенно при любом изменении выбора хотя бы одного элемента из выпадающего списка, даже без его закрытия.
### FlatStyle Название типа границ поля. Необязательный тэг. Ожидается название одного из стилей отображения поля:
FlatПлоское
PopupПлоское, пока не наведена мышь
StandardОбычное
SystemОпределяется операционной системой
По умолчанию используется значение Standard. ```xml Standard ``` ### NullValue Настройка отображения NULL-значения объекта. Необязательный тэг. Значение тэга ``: не ожидается. Если тэг `` отсутствует, то для атрибута `Show` используется значение False. ```xml ``` #### Атрибуты тэга \
Show

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

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

Если атрибут Show отсутствует, то используется значение False.

Значение True так же означает, что в список элементов на первую позицию будет добавлен элемент "[Все]", по нажатию на который будут отмечены все остальные элементы в списке.

Title

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

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

Если атрибут Title отсутствует, то используется пустое значение.

### NullValueTitle Отображаемое значение элемента, по нажатию на который будут отмечены все остальные элементы в списке. Необязательный тэг. Любое значение будет переведено в текстовое. Если тэг `` отсутствует, то используется пустое значение. Игнорируется при наличии атрибута `Title` в тэге [``](#nullvalue). ```xml [Все] ``` ### Formatting Условное форматирование элементов выпадающего списка на основе значений хранящихся в них данных. Необязательный тэг. Значение тэга ``: список тэгов [``](#formatting_back_color) и [``](#formatting_fore_color). ```xml [0] > {0} * {1} 10 20 [0] > {0} * {1} 10 20 ``` ### Тэг \ Используется в тэге [``](#formatting). Условный цвет фона элемента списка. Необязательный тэг. Значение тэга ``: не ожидается. #### Атрибуты тэга``
Name

Значение.

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

#### Тэг `` Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет. Обязательный тэг. Значение тэга ``: любое значение. Выражение для вычисления поддерживает переменные вида "\[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные). Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д. Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке . #### Тэг `` Переменные для подстановки в выражение для вычисления. Необязательный тэг. Значение тэга ``: список тэгов [``](#formatting_back_color_items_item). #### Тэг `` Переменная для подстановки в выражение для вычисления. Необязательный тэг. Значение тэга ``: любое значение. ### Тэг `` Используется в тэге [``](#formatting). Условный цвет шрифта элемента списка. Необязательный тэг. Значение тэга ``: не ожидается. #### Атрибуты тэга ``
Name

Значение.

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

#### Тэг `` Выражение для вычисления, возвращающее логическое значение, на основе которого форматирование будет применено или нет. Обязательный тэг. Значение тэга ``: любое значение. Выражение для вычисления поддерживает переменные вида "\[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные). Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д. Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке . #### Тэг `` Переменные для подстановки в выражение для вычисления. Необязательный тэг. Значение тэга ``: список тэгов [``](#formatting_fore_color_items_item). #### Тэг `` Переменная для подстановки в выражение для вычисления. Необязательный тэг. Значение тэга ``: любое значение. ### ValueList Элементы выпадающего списка. Необязательный тэг. Ожидается таблица с одним, двумя или более столбцами (например, ссылка на [`GetDataConnection`](/workflow-forms-syntax/workflow_forms/dataconnections.md)). Первое поле будет соответствовать реальному значению элемента, второе – его отображаемому значению (если второго поля нет, то отображаемое значение равно реальному). Все остальные поля могут быть опционально использованы в выражениях для условного форматирования элементов выпадающего списка. ```xml ``` ### Value Значение, соответствующее линейному массиву реальных значений выбранных элементов. Необязательный тэг. Любое значение (кроме NULL) будет преобразовано в линейный массив. Если поле имеет значение NULL, то элементы в выпадающем списке будут отмечены в зависимости от значения атрибута `Show` тэга [``](#null_value). Если атрибут `Show` равен True, то будут отмечены все элементы в списке, иначе - не будет выбран ни один. ```xml Value ``` ## Get-проперти для получения свойств ### DropDownHeight Возвращает высоту выпадающего списка. ```xml ``` ### DropDownWidth Возвращает ширину выпадающего списка. ```xml ``` ### InputLanguage Возвращает название языка для ограничения по вводимым символам. ```xml ``` ### InputCase Возвращает название типа регистра для ограничения по вводимым символам. ```xml ``` ### Sorted Возвращает признак сортировки элементов выпадающего списка по отображаемым значениям. ```xml ``` ### FlatStyle Возвращает название типа границ поля. ```xml ``` ### ValueList Возвращает элементы выпадающего списка (таблица с двумя столбцами). ```xml ``` ### ItemsCount Возвращает количество элементов в списке. ```xml ``` ### SelectedItemsCount Возвращает количество выбранных элементов в списке. ```xml ``` ### VisibleText Возвращает отображаемое значение поля, текстовый список выбранных элементов. ```xml ``` ### VisibleTextDelimeter Возвращает текстовый список выбранных элементов с заданным разделителем. ```xml \r ``` ## Set-проперти для динамического задания свойств ### DropDownHeight Задает высоту выпадающего списка. Ожидается целочисленное значение. ```xml 400 ``` ### DropDownWidth Задает ширину выпадающего списка. Ожидается целочисленное значение. ```xml 300 ``` ### InputLanguage Задает название языка для ограничения по вводимым символам. Ожидается один из языков. ```xml Rus ``` ### InputCase Задает название типа регистра для ограничения по вводимым символам. Ожидается один из типов регистров. ```xml Lower ``` ### Sorted Задает признак сортировки элементов выпадающего списка по отображаемым значениям. Ожидается логическое значение. ```xml True ``` ### FlatStyle Задает название типа границ поля. Ожидается одно из названий типов границ поля. ```xml Popup ``` ### ValueList Задает элементы выпадающего списка. Ожидается таблица с двумя столбцами (например, ссылка на [`GetDataConnection`](/workflow-forms-syntax/workflow_forms/dataconnections.md) с указанием двух его полей). ```xml ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/objects/checkedcombobox.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.