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

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

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

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

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

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

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

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

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

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

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

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

InputLanguage

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

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

Rus

Русский

Eng

Английский

None

Без ограничений по языку

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

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

InputCase

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

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

Upper

Верхний регистр

Lower

Нижний регистр

None

Без ограничений по регистру

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

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

SearchMode

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

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

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

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

Value

Значение.

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

NullValue

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

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

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

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

Show

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

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

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

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

Title

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

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

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

NullValueTitle

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

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

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

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

ValueList

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

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

Первое поле будет соответствовать реальному значению элемента, второе – его отображаемому значению (если второго поля нет, то отображаемое значение равно реальному).

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

Value

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

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

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

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

DropDownHeight

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

DropDownWidth

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

InputLanguage

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

InputCase

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

ValueList

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

ItemsCount

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

SelectedItemsCount

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

VisibleText

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

VisibleTextDelimeter

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

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

DropDownHeight

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

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

DropDownWidth

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

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

InputLanguage

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

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

InputCase

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

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

ValueList

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

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

Last updated