# Column ## Шаблон столбцов DatabaseTable Перечень возможных общих тэгов для всех типов столбцов: ```xml ``` ## Тэги, общие для всех столбцов таблицы ### Title Заголовок столбца. Необязательный тэг. Любое значение будет переведено в текстовое. По умолчанию используется название столбца из атрибута `Name` тэга ``. ```xml Заголовок ``` ### Width Ширина столбца. Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется стандартное значение .NET. ```xml 100 ``` ### MinimumWidth Минимальная ширина столбца. Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется стандартное значение .NET. ```xml 100 ``` ### DisplayIndex Порядок отображения столбца. Необязательный тэг. Ожидается неотрицательное целочисленное значение. По умолчанию используется порядок описания столбцов в таблице. ```xml 0 ``` ### Frozen Признак, определяющий, будет столбец "заморожен" (видим всегда) при горизонтальной прокрутке содержимого таблицы. Необязательный тэг. Значение тэга не ожидается. Обязательный атрибут `Value` ожидает логическое значение. По умолчанию используется значение False. ```xml ``` ### WrapMode Признак, определяющий, будут ли в содержании ячеек столбца переносы на новую строку, если все содержание ячейки не входит в ее видимую область. Необязательный тэг. Значение тэга не ожидается. Обязательный атрибут `Value` ожидает логическое значение. По умолчанию используется значение False. ```xml ``` ### ReadOnly Признак, определяющий, может ли пользователь изменять значения ячеек данного столбца. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### AllowSort Признак, определяющий, можно ли отсортировать столбец по нажатию на его заголовок из графического интерфейса таблицы. Необязательный тэг. Значение тэга не ожидается. Обязательный атрибут `Value` ожидает логическое значение. По умолчанию используется значение True. ```xml ``` ### Alignment Название типа положения содержимого ячейки столбца. Необязательный тэг. {% hint style="info" %} Не распространяется на столбец типа [DatabaseTableColumnCheckBox](/workflow-forms-syntax/workflow_forms/objects/databasetable/column/column_check_box.md). {% endhint %} ```xml ``` Для обязательного атрибута `Value` ожидается название одного из типов положения содержимого ячейки столбца таблицы:
NotSetЗначение наследуется от свойства <ColumnHeadersAlignment> таблицы
(По умолчанию)
TopLeftСодержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
TopCenterСодержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки
TopRightСодержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
MiddleLeftСодержимое выравнивается вертикально по середине и горизонтально по левому краю ячейки в горизонтальном направлении
MiddleCenterСодержимое выравнивается по вертикальному и горизонтальному центру ячейки
MiddleRightСодержимое выравнивается вертикально по середине и горизонтально по правому краю ячейки в горизонтальном направлении
BottomLeftСодержимое выравнивается по нижнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
BottomCenterСодержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки
BottomRightСодержимое выравнивается по нижнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
### HeaderAlignment Название типа положения содержимого заголовка столбца. Необязательный тэг. ```xml ``` Для обязательного атрибута `Value` ожидается название одного из типов положения содержимого ячейки столбца таблицы:
NotSetЗначение наследуется от свойства <ColumnHeadersAlignment> таблицы
(По умолчанию)
TopLeftСодержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
TopCenterСодержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки
TopRightСодержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
MiddleLeftСодержимое выравнивается вертикально по середине и горизонтально по левому краю ячейки в горизонтальном направлении
MiddleCenterСодержимое выравнивается по вертикальному и горизонтальному центру ячейки
MiddleRightСодержимое выравнивается вертикально по середине и горизонтально по правому краю ячейки в горизонтальном направлении
BottomLeftСодержимое выравнивается по нижнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
BottomCenterСодержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки
BottomRightСодержимое выравнивается по нижнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
### AutoSizeMode Название типа автоматического изменения ширины столбца. Необязательный тэг. ```xml ``` Для обязательного атрибута `Value` ожидается название одного из типов автоматического изменения ширины столбцов таблицы:
NotSetЗначение наследуется от свойства <AutoSizeColumnsMode> таблиц
(По умолчанию)
NoneНет автоматического изменения ширины столбца
AllCellsШирина столбца изменяется в соответствии с содержимым всех ячеек в столбце, включая ячейки заголовка
AllCellsExceptHeaderШирина столбца изменяется в соответствии с содержимым всех ячеек в столбце, исключая ячейки заголовка
ColumnHeaderШирина столбца изменяется в соответствии с содержимым заголовка столбцов
DisplayedCellsШирина столбца изменяется в соответствии с содержимым всех ячеек в столбце, отображаемых в текущий момент на экране, включая ячейки заголовка
DisplayedCellsExceptHeadersШирина столбца изменяется в соответствии с содержимым всех ячеек в столбце, отображаемых в текущий момент на экране, исключая ячейки заголовка
FillШирина столбца изменяется так, чтобы точно заполнить ширину всей отображаемой области таблицы, с учетом наличия или отсутствия полосы горизонтальной прокрутки
### HeaderBackColor Цвет фона заголовка столбца. Необязательный тэг. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml HeaderBackColor ``` ### HeaderForeColor Цвет шрифта заголовка столбца. Необязательный тэг. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml HeaderForeColor ``` ### HeaderSelectionBackColor Цвет фона заголовка столбца выделенной ячейки. Необязательный тэг. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml HeaderForeColor ``` ### BackColor Цвет фона ячеек столбца. Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml BackColor ``` ### ForeColor Цвет шрифта ячеек столбца. Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml ForeColor ``` ### Visible Признак видимости столбца. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение True. ```xml True ``` ### Hint Подсказка, всплывающая на заголовке столбца. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml Подсказка ``` ### ToolTipColumnName Имя столбца, значение ячейки которого будет использоваться во всплывающей подсказке при наведении курсора мыши на ячейку той же строки в настраиваемом столбце. Необязательный тэг. Любое значение будет переведено в текстовое. По умолчанию для подсказки используется значение из текущего столбца. ```xml ColumnName ``` ### DataType Настройки форматированного вывода значений в ячейках столбца. Необязательный тэг. Значение тэга не ожидается. ```xml ``` Для обязательного атрибута `Type` ожидается название одного из [типов данных](broken://pages/-MaRtBVKMO4VR0KCghVx). {% hint style="warning" %} Остальные атрибуты тэга зависят от указанного типа данных. {% endhint %} ### Sorting Правила автоматической сортировки столбца. Необязательный тэг. В качестве значения ожидаются тэги `` и ``. ```xml ``` Необязательный тэг `` задает тип сортировки:
Asc

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

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

DescПо убыванию
Обязательный тэг `` задает приоритет столбца при сортировке. Чем значение меньше, тем выше приоритет. ### Filter Правила фильтрации (отображения) строк в таблице. Необязательный тэг. Значение тэга любое значение. ```xml ``` Необязательный атрибут `AutoFill` - признак, определяющий, будет ли передан список уникальных значений ячеек настраиваемого столбца в свойство ValueList объекта, указанного в тэге ``. Ожидается логическое значение. По умолчанию используется значение True. {% hint style="warning" %} Список уникальных значений будет отправлен только в тот объект формы, который имеет set-проперти ValueList. Во всех остальных случаях атрибут `AutoFill` ни на что не влияет. {% endhint %} Необязательный атрибут `FilterNullValue` - признак, определяющий, будет ли осуществляться фильтрация столбца, если фильтр будет иметь значение NULL. Ожидается логическое значение. По умолчанию используется значение False. ### Substitution Подстановка в ячейки столбца значений, зависящих от значений в других столбцах. Необязательный тэг. Ожидается таблица с двумя столбцами. Первый столбец должен содержать реальные значения элементов, а второй - их отображаемое значение. ```xml ``` В обязательном атрибуте `SourceColumn` ожидается имя одного из столбцов редактируемой таблицы DatabaseTable. Значение из ячейки этого столбца будет использоваться для поиска значения в матрице, указанной в тэге ``. Найденное значение будет подставляться в ячейку настраиваемого столбца. Подстановка происходит построчно. ### DefaultNewRowValue Значение по умолчанию для ячейки столбца при добавлении новой строке в таблицу. Необязательный тэг. Ожидается любое значение. ```xml Value ``` ### AutoFill Автоматическое заполнение значений в ячейках столбца. Необязательный тэг. Значение тэга не ожидается. ```xml ``` Обязательный атрибут `Type` задает тип автоматического заполнения. Ожидается название одного из типов:
RowNumberНомер по порядку
### Calculate Задает выражение для вычисляемого столбца. Необязательный тэг. В качестве значения ожидаются тэги `` и ``. ```xml (ColumnName1 * ColumnName2 + {0}) * {1} 100 ``` Обязательный тэг `` задает выражение для вычисления значений настраиваемого столбца. Для каждой строки значение вычисляется отдельно. Выражение поддерживает обращение к значениям в других столбцах через указание имени столбца, а так же обращение к элементам, перечисленным в тэге ``, по их индексу - {N}. {% hint style="info" %} Все конструкции, поддерживаемые в выражении вычисляемого столбца, можно найти по [ссылке](https://docs.microsoft.com/en-us/dotnet/api/system.data.datacolumn.expression?redirectedfrom=MSDN\&view=net-6.0#System_Data_DataColumn_Expression). {% endhint %} Необязательный тэг `` ожидает список тэгов `` - список переменных для подстановки в выражение. Для необязательного тэга `` ожидается любое значение. ### ManagementMode Используется, чтобы указать режим управления отображением столбца. Необязательный тэг. Ожидается название одного из режимов управления:
AllowedРазрешено изменять порядок и видимость столбца
(По умолчанию)
NotAllowedЗапрещено изменять порядок и видимость столбца
PartiallyAllowedРазрешено изменять порядок, запрещено изменять видимость столбца
```xml Allowed ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/objects/databasetable/column.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.