Column

Описание тэгов, общих для всех типов столбцов таблицы DatabaseTable

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

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

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

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

Title

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

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

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

По умолчанию используется название столбца из атрибута Name тэга <Column>.

Width

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

<Width>100</Width>

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

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

MinimumWidth

Минимальная ширина столбца.

<MinimumWidth>100</MinimumWidth>

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

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

DisplayIndex

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

<DisplayIndex>0</DisplayIndex>

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

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

Frozen

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

<Frozen Value="False" />

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

Обязательный атрибут Value ожидает логическое значение. По умолчанию используется значение False.

WrapMode

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

<WrapMode Value="False" />

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

Обязательный атрибут Value ожидает логическое значение. По умолчанию используется значение False.

ReadOnly

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

<ReadOnly>False</ReadOnly>

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

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

AllowSort

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

<AllowSort Value="False" />

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

Обязательный атрибут Value ожидает логическое значение. По умолчанию используется значение True.

Alignment

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

<Alignment Value="NotSet" />

Необязательный тэг.

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

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

NotSet

TopLeft

Содержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении

TopCenter

Содержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки

TopRight

Содержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении

MiddleLeft

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

MiddleCenter

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

MiddleRight

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

BottomLeft

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

BottomCenter

Содержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки

BottomRight

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

HeaderAlignment

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

<HeaderAlignment Value="NotSet" />

Необязательный тэг.

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

NotSet

TopLeft

Содержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении

TopCenter

Содержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки

TopRight

Содержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении

MiddleLeft

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

MiddleCenter

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

MiddleRight

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

BottomLeft

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

BottomCenter

Содержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки

BottomRight

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

AutoSizeMode

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

<AutoSizeMode Value="NotSet" />

Необязательный тэг.

Для обязательного атрибута Value ожидается название одного из типов автоматического изменения ширины столбцов таблицы:

NotSet

None

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

AllCells

Ширина столбца изменяется в соответствии с содержимым всех ячеек в столбце, включая ячейки заголовка

AllCellsExceptHeader

Ширина столбца изменяется в соответствии с содержимым всех ячеек в столбце, исключая ячейки заголовка

ColumnHeader

Ширина столбца изменяется в соответствии с содержимым заголовка столбцов

DisplayedCells

Ширина столбца изменяется в соответствии с содержимым всех ячеек в столбце, отображаемых в текущий момент на экране, включая ячейки заголовка

DisplayedCellsExceptHeaders

Ширина столбца изменяется в соответствии с содержимым всех ячеек в столбце, отображаемых в текущий момент на экране, исключая ячейки заголовка

Fill

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

HeaderBackColor

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

<HeaderBackColor>HeaderBackColor</HeaderBackColor>

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

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

HeaderForeColor

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

<HeaderForeColor>HeaderForeColor</HeaderForeColor>

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

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

BackColor

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

<BackColor>BackColor</BackColor>

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

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

ForeColor

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

<ForeColor>ForeColor</ForeColor>

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

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

Visible

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

<Visible>True</Visible>

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

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

Hint

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

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

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

ToolTipColumnName

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

<ToolTipColumnName>ColumnName</ToolTipColumnName>

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

По умолчанию для подсказки используется значение из текущего столбца.

DataType

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

<DataType Type="DataType" />

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

Для обязательного атрибута Type ожидается название одного из типов данных.

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

Sorting

Правила автоматической сортировки столбца.

<Sorting>
  <SortOrder Type="Asc" />
  <ColumnOrder Order="1" />
</Sorting>

Необязательный тэг. В качестве значения ожидаются тэги <SortOrder> и <ColumnOrder>.

Необязательный тэг <SortOrder> задает тип сортировки:

Asc

По возрастанию

(По умолчанию)

Desc

По убыванию

Обязательный тэг <ColumnOrder> задает приоритет столбца при сортировке. Чем значение меньше, тем выше приоритет.

Filter

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

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

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

Необязательный атрибут AutoFill - признак, определяющий, будет ли передан список уникальных значений ячеек настраиваемого столбца в свойство ValueList объекта, указанного в тэге <Filter>.

Ожидается логическое значение. По умолчанию используется значение True.

Список уникальных значений будет отправлен только в тот объект формы, который имеет set-проперти ValueList. Во всех остальных случаях атрибут AutoFill ни на что не влияет.

Необязательный атрибут FilterNullValue - признак, определяющий, будет ли осуществляться фильтрация столбца, если фильтр будет иметь значение NULL.

Ожидается логическое значение. По умолчанию используется значение False.

Substitution

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

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

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

В обязательном атрибуте SourceColumn ожидается имя одного из столбцов редактируемой таблицы DatabaseTable. Значение из ячейки этого столбца будет использоваться для поиска значения в матрице, указанной в тэге <Substitution>. Найденное значение будет подставляться в ячейку настраиваемого столбца. Подстановка происходит построчно.

DefaultNewRowValue

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

<DefaultNewRowValue>Value</DefaultNewRowValue>

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

AutoFill

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

<AutoFill Type="RowNumber" />

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

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

RowNumber

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

Calculate

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

<Calculate>
  <Expression>(ColumnName1 * ColumnName2 + {0}) * {1}</Expression>
  <Items>
    <Item>100</Item>
    <Item>
      <Object Name="ObjectTextBox" />
    </Item>
  </Items>
</Calculate>

Необязательный тэг. В качестве значения ожидаются тэги <Expression> и <Items>.

Обязательный тэг <Expression> задает выражение для вычисления значений настраиваемого столбца. Для каждой строки значение вычисляется отдельно. Выражение поддерживает обращение к значениям в других столбцах через указание имени столбца, а так же обращение к элементам, перечисленным в тэге <Items>, по их индексу - {N}.

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

Необязательный тэг <Items> ожидает список тэгов <Item> - список переменных для подстановки в выражение. Для необязательного тэга <Item> ожидается любое значение.

ManagementMode

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

<ManagementMode>Allowed</ManagementMode>

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

Allowed

Разрешено изменять порядок и видимость столбца (По умолчанию)

NotAllowed

Запрещено изменять порядок и видимость столбца

PartiallyAllowed

Разрешено изменять порядок, запрещено изменять видимость столбца

Last updated