Платформа WT
Синтаксис
База знаний

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

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

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

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

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

Width

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

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

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

<Width>100</Width>

MinimumWidth

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

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

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

<MinimumWidth>100</MinimumWidth>

DisplayIndex

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

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

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

<DisplayIndex>0</DisplayIndex>

Frozen

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

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

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

<Frozen Value="False" />

WrapMode

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

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

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

<WrapMode Value="False" />

ReadOnly

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

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

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

<ReadOnly>False</ReadOnly>

AllowSort

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

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

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

<AllowSort Value="False" />

Alignment

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

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

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

<Alignment Value="NotSet" />

Для обязательного атрибута 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

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

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

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

<HeaderBackColor>HeaderBackColor</HeaderBackColor>

HeaderForeColor

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

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

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

<HeaderForeColor>HeaderForeColor</HeaderForeColor>

HeaderSelectionBackColor

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

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

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

<HeaderForeColor>HeaderForeColor</HeaderForeColor>

BackColor

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

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

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

<BackColor>BackColor</BackColor>

ForeColor

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

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

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

<ForeColor>ForeColor</ForeColor>

Visible

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

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

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

<Visible>True</Visible>

Hint

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

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

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

ToolTipColumnName

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

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

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

<ToolTipColumnName>ColumnName</ToolTipColumnName>

DataType

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

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

<DataType Type="DataType" />

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

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

Sorting

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

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

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

Необязательный тэг <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

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

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

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

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

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

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

ManagementMode

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

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

Allowed

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

NotAllowed

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

PartiallyAllowed

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

<ManagementMode>Allowed</ManagementMode>

Last updated