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 2 years ago