# ComboBox ## Шаблон ComboBox Перечень всех возможных тэгов объекта: ```xml ``` ## Описание ComboBox ```xml ``` ### Получение значения Значением ComboBox считается реальное значение выбранного элемента из списка. ```xml ``` ### Задание значения Значение объекта: любое значение. ```xml ``` ## Тэги, специфичные для ComboBox ### EnterText Признак, определяющий, может ли пользователь вводить текст внутри поля. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### MaxLength Задает максимальное число символов, которое разрешается вводить или вставлять в поле. Необязательный тэг. Ожидается положительное целочисленное значение. По умолчанию используется значение 0, показывающее, что ограничения нет. ```xml 0 ``` ### ScrollWithWheel Признак, включающий или отключающий возможность изменять значение колесиком мышки. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение True. ```xml False ``` ### AutoCompleteMode Название типа автоматического завершения ввода содержимого поля. Необязательный тэг. Ожидается название одного из типов автоматического завершения ввода содержимого:
NoneНет автоматического завершения
SuggestПри вводе появляется список значений, совпадающих по началу (без учета регистра) с текущим значением поля
AppendПри вводе в поле появляется подсвеченное окончание значения, соответствующее элементу выпадающего списка, совпадающим по началу с текущим значением поля
SuggestAppendПрименение обеих настроек Suggest и Append
SmartSuggestПри вводе появляется список значений, хотя бы частично совпадающих (без учета регистра) с текущим значением поля
По умолчанию используется значение None. ```xml None ``` ### AutoCompleteSource Название типа источника данных для завершения ввода содержимого поля. Необязательный тэг. Ожидается название одного из типов источников данных для завершения ввода содержимого:
FileSystemФайловая система
HistoryListСписок истории посещенных URL-адресов
RecentlyUsedListСписок недавно посещенных URL-адресов
AllUrlОбъединяет обе настройки HistoryList и RecentlyUsedList
AllSystemSourcesОбъединяет обе настройки FileSystem и AllUrl
FileSystemDirectoriesТолько папки файловой системы
CustomSourceУказанный источник
NoneНет источника. Если AutoCompleteMode не SmartSuggest, то автозаполнения не будет
ListItemsЗначения выпадающего списка
По умолчанию используется значение None. ```xml None ``` ### Sorted Признак сортировки элементов выпадающего списка по отображаемым значениям. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### DropDownHeight Высота выпадающего списка. Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется стандартное значение .NET. ```xml 100 ``` ### DropDownWidth Ширина выпадающего списка. Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется значение ширины объекта. ```xml 200 ``` ### InputLanguage Название языка для ограничения по вводимым символам. Необязательный тэг. Ожидается название одного из языков:
RusРусский
EngАнглийский
NoneБез ограничений по языку
По умолчанию используется значение None. Если язык вводимого символа не совпадает с языком, указанном в данном тэге, то этот символ будет трансформирован в символ другого языка, расположенный на этой же клавише на клавиатуре. ```xml None ``` ### InputCase Название типа регистра для ограничения по вводимым символам. Необязательный тэг. Ожидается название одного из типов регистров:
UpperВерхний регистр
LowerНижний регистр
NoneБез ограничений по регистру
По умолчанию используется значение None. Если регистр вводимого символа не совпадает с регистром, указанном в данном тэге, то этот символ будет трансформирован в указанный регистр. ```xml None ``` ### FlatStyle Название типа границ поля. Необязательный тэг. Ожидается название одного из стилей отображения поля:
FlatПлоское
PopupПлоское, пока не наведена мышь
StandardОбычное
SystemОпределяется операционной системой
По умолчанию используется значение Standard. ```xml Standard ``` ### Text Текст поля (доступно в случае, если [``](#enter_text) имеет значение True). Необязательный тэг. Любое значение будет переведено в текстовое. Текстовое значение может быть присвоено, только если основное значение [``](#value) равно NULL. ```xml Текст ``` ### NullValue Настройка отображения NULL-значения объекта. Необязательный тэг. Значение тэга не ожидается. Если тэг `` отсутствует, то для атрибута `Show` используется значение False. ```xml ```
Show

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

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

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

Title

Отображаемое значение элемента, имеющего реальное значение NULL.

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

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

### NullValueTitle Отображаемое значение элемента, имеющего реальное значение NULL. Необязательный тэг. Любое значение будет переведено в текстовое. По умолчанию используется пустое значение. Игнорируется при наличии атрибута `Title` в тэге [``](#null_value). ```xml [не выбрано] ``` ### AllowOutOfList Признак, разрешающий полю принимать и хранить значение даже если это значение отсутствует в списке элементов поля. Необязательный тэг. Значение тэга не ожидается. Обязательный атрибут `Value` ожидает логическое значение. По умолчанию для атрибута `Value` используется значение False. ```xml ``` ### SelectFirstOnPressEnter Признак, включающий механизм выбора первого значения при нажатии клавиши Enter, если в выпадающем списке не выбрано значение. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение True. ```xml False ``` ### 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`](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/dataconnections)). Первое поле будет соответствовать реальному значению элемента, второе – его отображаемому значению (если второго поля нет, то отображаемое значение равно реальному). Все остальные поля могут быть опционально использованы в выражениях для условного форматирования элементов выпадающего списка. ```xml ``` ### Value Значение, соответствующее реальному значению выбранного элемента. Необязательный тэг. Значение тэга ``: любое значение. Если введенное в поле текстовое значение совпадает по отображаемому значению с одним из элементов выпадающего списка, то значение объекта равно реальному значению соответствующего элемента выпадающего списка, иначе - введенному в поле значению. ```xml Value ``` ## Get-проперти для получения свойств ### EnterText Возвращает признак, определяющий, может ли пользователь вводить текст внутри поля. ```xml ``` ### MaxLength Возвращает количество символов, которые пользователь может ввести внутри поля. ```xml ``` ### AutoCompleteMode Возвращает название типа автоматического завершения ввода содержимого поля. ```xml ``` ### AutoCompleteSource Возвращает название типа источника данных для завершения ввода содержимого поля. ```xml ``` ### Sorted Возвращает признак сортировки элементов выпадающего списка по отображаемым значениям. ```xml ``` ### DropDownHeight Возвращает высоту выпадающего списка. ```xml ``` ### DropDownWidth Возвращает ширину выпадающего списка. ```xml ``` ### InputLanguage Возвращает название языка для ограничения по вводимым символам. ```xml ``` ### InputCase Возвращает название типа регистра для ограничения по вводимым символам. ```xml ``` ### FlatStyle Возвращает название типа границ поля. ```xml ``` ### Text Возвращает отображаемое значение поля только в том случае, если реальное значение [``](#value) возвращает NULL. ```xml ``` ### VisibleText Возвращает отображаемое значение поля. ```xml ``` ### Percentage Возвращает значение в процентах от отображаемого значения поля (например, при отображаемом значении "0,95" проперти Percentage вернет 95). ```xml ``` ### Length Возвращает длину отображаемого текста поля. ```xml ``` ### ValueList Возвращает элементы выпадающего списка (таблица с двумя столбцами). ```xml ``` ## Set-проперти для динамического задания свойств ### EnterText Задает признак, определяющий, может ли пользователь вводить текст внутри поля. Ожидается логическое значение. ```xml True ``` ### MaxLength Задает количество символов, которые пользователь может ввести внутри поля. Ожидается целочисленное значение. ```xml 200 ``` ### AutoCompleteMode Задает название типа автоматического завершения ввода содержимого поля. Ожидается название одного из типов автоматического завершения ввода содержимого. ```xml Append ``` ### AutoCompleteSource Задает название типа источника данных для завершения ввода содержимого поля. Ожидается название одного из типов источников данных для завершения ввода содержимого. ```xml ListItems ``` ### Sorted Задает признак сортировки элементов выпадающего списка по отображаемым значениям. Ожидается логическое значение. ```xml True ``` ### DropDownHeight Задает высоту выпадающего списка. Ожидается целочисленное значение. ```xml 400 ``` ### DropDownWidth Задает ширину выпадающего списка. Ожидается целочисленное значение. ```xml 300 ``` ### InputLanguage Задает название языка для ограничения по вводимым символам. Ожидается один из языков. ```xml Rus ``` ### InputCase Задает название типа регистра для ограничения по вводимым символам. Ожидается один из типов регистров. ```xml Lower ``` ### FlatStyle Задает название типа границ поля. Ожидается одно из названий типов границ поля. ```xml Popup ``` ### Text Задает отображаемое значение поля. Любое значение будет переведено в текстовое. Текстовое значение может быть присвоено только если основное значение [``](#value) равно NULL. ```xml Текст ``` ### ValueList Задает элементы выпадающего списка. Ожидается таблица с двумя столбцами (например, ссылка на [`GetDataConnection`](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/dataconnections) с указанием двух его полей). ```xml ```