ComboBox

Графический объект; поле с выпадающим списком.

Шаблон ComboBox

Перечень всех возможных тэгов объекта:

<MyObject Name="" Type="ComboBox" 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>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для ComboBox-->
  <EnterText></EnterText>
  <MaxLength></MaxLength>
  <AutoCompleteMode></AutoCompleteMode>
  <AutoCompleteSource></AutoCompleteSource>
  <Sorted></Sorted>
  <DropDownHeight></DropDownHeight>
  <DropDownWidth></DropDownWidth>
  <InputLanguage></InputLanguage>
  <InputCase></InputCase>
  <FlatStyle></FlatStyle>
  <NullValue Show="" Title="" />
  <NullValueTitle></NullValueTitle>
  <AllowOutOfList Value="" />
  <Text></Text>
  <Formatting>
    <BackColor Name="">
      <Expression></Expression>
      <Items>
        <Item></Item>
        <Item></Item>
      </Items>
    </BackColor>
    <ForeColor Name="">
      <Expression></Expression>
      <Items>
        <Item></Item>
        <Item></Item>
      </Items>
    </ForeColor>
  </Formatting>
  <ValueList>
    <DataConnection SourceDataConnection="">
      <Fields>
        <Field Name="" />
        <Field Name="" />
      </Fields>
    </DataConnection>
  </ValueList>
  <Value></Value>
</MyObject>

Описание ComboBox

<MyObject Name="ComboBoxName" Type="ComboBox" Assembly="BaseControls">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для ComboBox-->
</MyObject>

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

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

<Object Name="ComboBoxName" />

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

Значение объекта: любое значение.

<Object Name="ComboBoxName"></Object>

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

EnterText

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

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

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

<EnterText>False</EnterText>

MaxLength

Задает максимальное число символов, которое разрешается вводить или вставлять в поле.

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

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

<MaxLength>0</MaxLength>

AutoCompleteMode

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

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

None	Нет автоматического завершения
Suggest	При вводе появляется список значений, совпадающих по началу (без учета регистра) с текущим значением поля
Append	При вводе в поле появляется подсвеченное окончание значения, соответствующее элементу выпадающего списка, совпадающим по началу с текущим значением поля
SuggestAppend	Применение обеих настроек Suggest и Append
SmartSuggest	При вводе появляется список значений, хотя бы частично совпадающих (без учета регистра) с текущим значением поля

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

<AutoCompleteMode>None</AutoCompleteMode>

AutoCompleteSource

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

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

FileSystem	Файловая система
HistoryList	Список истории посещенных URL-адресов
RecentlyUsedList	Список недавно посещенных URL-адресов
AllUrl	Объединяет обе настройки HistoryList и RecentlyUsedList
AllSystemSources	Объединяет обе настройки FileSystem и AllUrl
FileSystemDirectories	Только папки файловой системы
CustomSource	Указанный источник
None	Нет источника. Если AutoCompleteMode не SmartSuggest, то автозаполнения не будет
ListItems	Значения выпадающего списка

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

<AutoCompleteSource>None</AutoCompleteSource>

Sorted

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

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

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

<Sorted>False</Sorted>

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>

FlatStyle

Название типа границ поля.

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

Flat	Плоское
Popup	Плоское, пока не наведена мышь
Standard	Обычное
System	Определяется операционной системой

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

<FlatStyle>Standard</FlatStyle>

Text

Текст поля (доступно в случае, если <EnterText> имеет значение True).

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

Текстовое значение может быть присвоено, только если основное значение <Value> равно NULL.

<Text>Текст</Text>

NullValue

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

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

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

<NullValue Show="False" Title="[не выбрано]" />

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

Show	Признак, определяющий, будет ли в выпадающем списке элемент, имеющий реальное значение NULL. Необязательный атрибут. Ожидается логическое значение. По умолчанию используется значение False.
Title	Отображаемое значение элемента, имеющего реальное значение NULL. Необязательный атрибут. Любое значение будет переведено в текстовое. По умолчанию используется пустое значение.

NullValueTitle

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

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

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

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

<NullValueTitle>[не выбрано]</NullValueTitle>

AllowOutOfList

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

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

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

<AllowOutOfList Value="False" />

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

Value

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

Formatting

Условное форматирование элементов выпадающего списка на основе значений хранящихся в них данных.

Необязательный тэг. Значение тэга <Formatting>: список тэгов <BackColor> и <ForeColor>.

<Formatting>
  <BackColor Name="BackColorName">
    <Expression>[0] > {0} * {1}</Expression>
    <Items>
      <Item>10</Item>
      <Item>20</Item>
    </Items>
  </BackColor>
  <ForeColor Name="ForeColorName">
    <Expression>[0] > {0} * {1}</Expression>
    <Items>
      <Item>10</Item>
      <Item>20</Item>
    </Items>
  </ForeColor>
</Formatting>

Тэг <BackColor>

Используется в тэге <Formatting>.

Условный цвет фона элемента списка. Необязательный тэг.

Значение тэга <BackColor>: не ожидается.

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

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

Тэг <Expression>

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

Обязательный тэг. Значение тэга <Expression>: любое значение.

Выражение для вычисления поддерживает переменные вида "[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные).

Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д.

Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке https://ncalc.codeplex.com/wikipage?title=functions.

Тэг <Items>

Переменные для подстановки в выражение для вычисления.

Необязательный тэг. Значение тэга <Items>: список тэгов <Item>.

Тэг <Item>

Переменная для подстановки в выражение для вычисления.

Необязательный тэг. Значение тэга <Item>: любое значение.

Тэг <ForeColor>

Используется в тэге <Formatting>.

Условный цвет шрифта элемента списка.

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

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

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

Тэг <Expression>

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

Обязательный тэг. Значение тэга <Expression>: любое значение.

Выражение для вычисления поддерживает переменные вида "[N]", где N – порядковый номер столбца в таблице элементов списка (0 – реальное значение, 1 – отображаемое, 2-... – все остальные).

Выражение для вычисления поддерживает переменные вида "{N}" для подстановки значений (N+1)-ого элемента, то есть {0}, {1} и т.д.

Все поддерживаемые в выражении для вычисления конструкции смотрите по ссылке https://ncalc.codeplex.com/wikipage?title=functions.

Тэг <Items>

Переменные для подстановки в выражение для вычисления.

Необязательный тэг. Значение тэга <Items>: список тэгов <Item>.

Тэг <Item>

Переменная для подстановки в выражение для вычисления.

Необязательный тэг. Значение тэга <Item>: любое значение.

ValueList

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

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

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

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

<ValueList>
  <DataConnection SourceDataConnection="SourceDataConnectionName">
    <Fields>
      <Field Name="Field1Name" />
      <Field Name="Field2Name" />
    </Fields>
  </DataConnection>
</ValueList>

Value

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

Необязательный тэг. Значение тэга <Value>: любое значение.

Если введенное в поле текстовое значение совпадает по отображаемому значению с одним из элементов выпадающего списка, то значение объекта равно реальному значению соответствующего элемента выпадающего списка, иначе - введенному в поле значению.

<Value>Value</Value>

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

EnterText

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

<Object Name="ComboBoxName">
  <Property Name="EnterText" />
</Object>

MaxLength

Возвращает количество символов, которые пользователь может ввести внутри поля.

<Object Name="ComboBoxName">
  <Property Name="MaxLength" />
</Object>

AutoCompleteMode

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

<Object Name="ComboBoxName">
  <Property Name="AutoCompleteMode" />
</Object>

AutoCompleteSource

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

<Object Name="ComboBoxName">
  <Property Name="AutoCompleteSource" />
</Object>

Sorted

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

<Object Name="ComboBoxName">
  <Property Name="Sorted" />
</Object>

DropDownHeight

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

<Object Name="ComboBoxName">
  <Property Name="DropDownHeight" />
</Object>

DropDownWidth

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

<Object Name="ComboBoxName">
  <Property Name="DropDownWidth" />
</Object>

InputLanguage

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

<Object Name="ComboBoxName">
  <Property Name="InputLanguage" />
</Object>

InputCase

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

<Object Name="ComboBoxName">
  <Property Name="InputCase" />
</Object>

FlatStyle

Возвращает название типа границ поля.

<Object Name="ComboBoxName">
  <Property Name="FlatStyle" />
</Object>

Text

Возвращает отображаемое значение поля только в том случае, если реальное значение <Value> возвращает NULL.

<Object Name="ComboBoxName">
  <Property Name="Text" />
</Object>

VisibleText

Возвращает отображаемое значение поля.

<Object Name="ComboBoxName">
  <Property Name="VisibleText" />
</Object>

Percentage

Возвращает значение в процентах от отображаемого значения поля (например, при отображаемом значении "0,95" проперти Percentage вернет 95).

<Object Name="ComboBoxName">
  <Property Name="Percentage" />
</Object>

Length

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

<Object Name="ComboBoxName">
  <Property Name="Length" />
</Object>

ValueList

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

<Object Name="ComboBoxName">
  <Property Name="ValueList" />
</Object>

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

EnterText

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

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

<Object Name="ComboBoxName">
  <Property Name="EnterText">True</Property>
</Object>

MaxLength

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

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

<Object Name="ComboBoxName">
  <Property Name="MaxLength">200</Property>
</Object>

AutoCompleteMode

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

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

<Object Name="ComboBoxName">
  <Property Name="AutoCompleteMode">Append</Property>
</Object>

AutoCompleteSource

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

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

<Object Name="ComboBoxName">
  <Property Name="AutoCompleteSource">ListItems</Property>
</Object>

Sorted

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

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

<Object Name="ComboBoxName">
  <Property Name="Sorted">True</Property>
</Object>

DropDownHeight

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

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

<Object Name="ComboBoxName">
  <Property Name="DropDownHeight">400</Property>
</Object>

DropDownWidth

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

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

<Object Name="ComboBoxName">
  <Property Name="DropDownWidth">300</Property>
</Object>

InputLanguage

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

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

<Object Name="ComboBoxName">
  <Property Name="InputLanguage">Rus</Property>
</Object>

InputCase

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

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

<Object Name="ComboBoxName">
  <Property Name="InputCase">Lower</Property>
</Object>

FlatStyle

Задает название типа границ поля.

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

<Object Name="ComboBoxName">
  <Property Name="FlatStyle">Popup</Property>
</Object>

Text

Задает отображаемое значение поля.

Любое значение будет переведено в текстовое.

Текстовое значение может быть присвоено только если основное значение <Value> равно NULL.

<Object Name="ComboBoxName">
  <Property Name="Text">Текст</Property>
</Object>

ValueList

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

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

<Object Name="ComboBoxName">
  <Property Name="ValueList">
    <DataConnection SourceDataConnection="SourceDataConnectionName">
      <Fields>
        <Field Name="Field1Name" />
        <Field Name="Field2Name" />
      </Fields>
    </DataConnection>
  </Property>
</Object>