Column

Шаблон столбцов DatabaseTable

Перечень возможных общих тэгов для всех типов столбцов:

<Column Name="" Type="" Assembly="DatabaseTableColumnControls" ><Column Name="" Type="DatabaseTableColumnTextBox" Assembly="DatabaseTableColumnControls" >
  <!--Тэги, общие для всех типов столбцов-->    
  <Title></Title> 
  <Width></Width>
  <DisplayIndex></DisplayIndex>
  <WrapMode Value="" />
  <Alignment Value="" />
  <HeaderAlignment Value="" />
  <AutoSizeMode Value="" />
  <HeaderBackColor></HeaderBackColor>
  <BackColor></BackColor>
  <ForeColor></ForeColor>
  <Visible></Visible>
  <Hint></Hint>
  <DataType DataType="" />
  <Substitution SourceColumn="">
    <DataConnection SourceDataConnection="">
      <Fields>
        <Field Name="" />
        <Field Name="" />
      </Fields>
    </DataConnection>
  </Substitution>
  <Filter AutoFill="" FilterNullValue=""></Filter>
  <DefaultNewRowValue></DefaultNewRowValue>
  <AutoFill Type="" />
  <Calculate>
    <Expression></Expression>
    <Items>
      <Item></Item>
      <Item></Item>
    </Items>
  </Calculate>
  <!--Тэги, специфичные для определенного типа столбца-->
</Column>

Атрибуты столбцов DatabaseTable

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

Тэги, общие для всех столбцов таблицы

Title

Заголовок столбца.

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

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

<Title>Заголовок</Title>

Width

Ширина столбца.

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

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

<Width>100</Width>

DisplayIndex

Порядок отображения столбца.

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

Если тэг <DisplayIndex> отсутствует, то используется значение от 0 до N-1, где N - количество столбцов таблицы (видимых и невидимых), в зависимости от порядка описания столбцов в таблице.

<DisplayIndex>0</DisplayIndex>

WrapMode

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

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

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

<WrapMode Value="False" />

Если значение атрибута Value тэга <WrapMode> установлено в True, то высота строк может увеличиться в зависимости от содержимого ячейки.

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

Value

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

Alignment

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

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

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

Не распространяется на столбец типа DatabaseTableCheckBoxColumn.

<Alignment Value="NotSet" />

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

Value

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

HeaderAlignment

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

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

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

<HeaderAlignment Value="NotSet" />

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

Value

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

Типы положения содержимого ячейки столбца

NotSet	Значение наследуется от свойства <ColumnHeadersAlignment> таблицы
TopLeft	Содержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
TopCenter	Содержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки
TopRight	Содержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
MiddleLeft	Содержимое выравнивается вертикально по середине и горизонтально по левому краю ячейки в горизонтальном направлении
MiddleCenter	Содержимое выравнивается по вертикальному и горизонтальному центру ячейки
MiddleRight	Содержимое выравнивается вертикально по середине и горизонтально по правому краю ячейки в горизонтальном направлении
BottomLeft	Содержимое выравнивается по нижнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
BottomCenter	Содержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки
BottomRight	Содержимое выравнивается по нижнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении

AutoSizeMode

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

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

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

<AutoSizeMode Value="NotSet" />

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

Value

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

Типы автоматического изменения ширины столбцов таблицы

None	Нет автоматического изменения ширины столбца
Fill	Ширина столбца изменяется так, чтобы точно заполнить ширину всей отображаемой области таблицы, с учетом наличия или отсутствия полосы горизонтальной прокрутки

HeaderBackColor

Цвет фона заголовка столбца.

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

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

<HeaderBackColor>HeaderBackColor</HeaderBackColor>

BackColor

Цвет фона ячеек столбца.

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

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

<BackColor>BackColor</BackColor>

ForeColor

Цвет шрифта ячеек столбца.

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

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

<ForeColor>ForeColor</ForeColor>

Visible

Признак видимости столбца.

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

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

<Visible>True</Visible>

Hint

Подсказка, всплывающая на заголовке столбца.

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

<Hint>Подсказка</Hint>

ToolTipColumnName

Имя столбца, значение которого будет использовано для всплывающей подсказки при наведении курсора мыши на ячейку таблицы. Для каждой ячейки настраиваемого столбца в подсказке будет значение из ячейки той же строки столбца, имя которого задано в тэге <ToolTipColumnName>.

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

Если тэг <ToolTipColumnName> отсутствует, то используется значение из текущего столбца.

<ToolTipColumnName>ColumnName</ToolTipColumnName>

DataType

Настройки форматированного вывода значений в ячейках столбца.

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

<DataType Type="DataType" />

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

Type	Тип данных, к которому приводятся значения. Обязательный атрибут. Значение атрибута Type: название одного из типов данных.

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

Filter

Правила фильтрации (отображения) строк в таблице.

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

<Filter AutoFill="True" FilterNullValue="False">
  <Object Name="ObjectComboBox" />
</Filter>

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

AutoFill

Признак, определяющий, будет ли передан список уникальных значений ячеек данного столбца в проперти <ValueList> объекта, указанного в тэге <Filter>. Необязательный атрибут. Ожидается логическое значение. Если атрибут AutoFill не задан, то используется значение True. Замечание. Список уникальных значений будет отправлен только в том случае, если в качестве значения тэга <Filter> объект формы, который имеет проперти для <ValueList>. То есть во всех остальных случаях атрибут AutoFill ни на что не влияет.

FilterNullValue

Признак, определяющий, будет ли осуществляться фильтрация столбца, если значение фильтра будет равно NULL. Необязательный атрибут. Ожидается логическое значение. Если атрибут FilterNullValue не задан, то используется значение False.

Substitution

Подстановка в ячейки столбца значений, зависящих от значений в других столбцах.

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

Для каждой ячейки данного столбца подстановка происходит следующим образом:

1. В этой же строке таблицы в столбце SourceColumnName находится определенное значение.

2. Данный столбец ищет строку в матрице, указанной в тэге <Substitution>, первая колонка которой имеет именно это значение.

3. Значение второй колонки найденной строки substitution-матрицы подставляется в качестве значения в ячейку данного столбца.

<Substitution SourceColumn="SourceColumnName">
  <DataConnection SourceDataConnection="SourceDataConnectionName">
    <Fields>
      <Field Name="Field1Name" />
      <Field Name="Field2Name" />
    </Fields>
  </DataConnection>
</Substitution>

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

SourceColumn

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

DefaultNewRowValue

Значение по умолчанию для ячейки столбца при добавлении новой строке в таблицу.

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

<DefaultNewRowValue>Value</DefaultNewRowValue>

AutoFill

Автоматическое заполнение значений в ячейках столбца.

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

<AutoFill Type="RowNumber" />

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

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

Типы автоматического заполнения столбца таблицы

RowNumber

Номер по порядку

Calculate

Настройки вычисляемого столбца.

Необязательный тэг. Значение тэга <Calculate>: два тэга - <Expression> и <Items>.

<Calculate>
  <Expression>(Field1 * Field2 + {1}) * {2}</Expression>
  <Items>
    <Item>100</Item>
    <Item>
      <Object Name="ObjectTextBox" />
    </Item>
  </Items>
</Calculate>

Тэг <Expression>

Выражение для вычисляемого столбца.

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

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

Все поддерживаемые в выражении для вычисляемого столбца конструкции смотрите по ссылке "http://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression.aspx".

Тэг <Items>

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

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

Тэг <Item>

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

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