Общие свойства

В этом разделе описываются свойства компонента Таблица данных, общие для всех унаследованных компонентов.

Показать строку поиска

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

Имя переменной:

enableSearch

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableSearch

Boolean

Показать строку поиска

Заполнитель в поиске

Сообщение, которое отображается в строке поиска, если не введен другой текст.

Имя переменной:

searchPlaceholder

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

searchPlaceholder

String

Заполнитель в поиске

Разрешить расширенный поиск

Включает расширенные параметры фильтрации для компонента.

Имя переменной:

enableAdvancedSearch

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableAdvancedSearch

Boolean

Разрешить расширенный поиск

Расширенный поиск по вычисляемым полям

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

Имя переменной:

classInstanceAdvancedSearchCalculatedFields

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

classInstanceAdvancedSearchCalculatedFields

Boolean

Расширенный поиск по вычисляемым полям

Только чтение

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

Имя переменной:

readOnly

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

readOnly

Boolean

Только чтение

Генерировать события “Строка добавлена”

Включает генерацию событий “Строка добавлена”

Имя переменной:

generateRowAddedEvents

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

generateRowAddedEvents

Boolean

Генерировать события “Строка добавлена”

Генерировать события “Строка удалена”

Включает генерацию событий “Строка удалена”

Имя переменной:

generateRowRemovedEvents

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

generateRowRemovedEvents

Boolean

Генерировать события “Строка удалена”

Генерировать события “Строка обновлена”

Включает генерацию событий “Строка обновлена”

Имя переменной:

generateCellUpdatedEvents

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

generateCellUpdatedEvents

Boolean

Генерировать события “Строка обновлена”

Множественная сортировка колонок

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

Имя переменной:

multipleSorting

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

multipleSorting

Boolean

Сортировка нескольких столбцов

Показать панель инструментов

Этот флаг определяет отображение панели инструментов журнала событий.

Имя переменной:

showToolbar

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showToolbar

Boolean

Показать панель инструментов

Включить контекстное меню

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

Имя переменной:

enableContextMenu

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableContextMenu

Boolean

Включить контекстное меню

Число элементов на странице

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

Имя переменной:

rowsPerPage

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

rowsPerPage

Integer

Элементы на странице

Пользовательские значения выбора 'Строка на странице'

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

Имя переменной:

customPaginatorValues

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

value

Integer

Значение. Количество элементов на странице.

Показать селектор «Число элементов на странице»

Этот флаг указывает, будет ли отображаться селектор 'Элементы на странице'.

Имя переменной:

showRowsPerPageSelector

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showRowsPerPageSelector

Boolean

Show 'Items Per Page' Selector

Тип селектора 'Элементы на странице'

Определяет тип селектора 'Items per Page'. Это свойство имеет два значения выбора

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

  • Группа кнопок - селектор будет отображаться в виде набора кнопок

Имя переменной:

rowsPerPageSelectorType

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

rowsPerPageSelectorType

String

Тип селектора 'Элементы на странице'

Пользовательские значения селектора «Число элементов на странице»

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

Имя переменной:

pageSizeOptions

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

value

Integer

Значение. Количество элементов на странице.

Показать селектор «Число элементов на странице»

Этот флаг определяет, будет ли отображаться селектор "Число элементов на странице".

Имя переменной:

showPageSizeSelector

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showPageSizeSelector

Boolean

Показать селектор «Число элементов на странице»

Тип селектора «Число элементов на странице»

Определяет тип селектора "Строк на странице". Данное свойство имеет два возможных значения:

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

  • Группа кнопок - селектор будет отображаться в виде набора кнопок

Имя переменной:

pageSizeSelectorType

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

pageSizeSelectorType

String

Тип селектора «Число элементов на странице»

Фиксированный формат

Если включено, применяет к таблице пользовательский формат, указанный в свойстве Формат.

Имя переменной:

fixedFormat

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

fixedFormat

Boolean

Фиксированный формат

Формат

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

Имя переменной:

format

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

format

Data Table

Формат

Имя столбца идентификатора записи

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

Имя переменной:

idColumn

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

idColumn

String

Имя столбца идентификатора записи

Выражение выбора строк

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

Имя переменной:

selectedRowsExpression

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

selectedRowsExpression

String

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

  • Если результат True, строка будет отображаться как выделенная.

  • Иначе, выбранная строка будет отображаться как невыделенная.

Среда вычисления выражения выбора строк:

Таблица данных по умолчанию

Таблица данных компонента

Контекст по умолчанию

Нет.

Ряд по умолчанию

Текущая обрабатываемая строка таблицы данных по умолчанию

Переменные окружения

Только Стандартные переменные.

Настройки столбцов

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

Имя переменной:

columnsSettings

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

name

String

Имя. Имя столбца.

fixed

String

Фиксированная Колонка.

headerTextBehavior

String

Поведение текста заголовка.

wordBreak

String

Перенос строк. Определяет поведение переноса строки, если текст выходит за пределы ячейки столбца.

visibleLength

Integer

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

textAlignHorizontal

String

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

textAlignHeaderHorizontal

String

Горизонтальное выравнивание текста заголовка. Определяет горизонтальное положение текста в заголовке столбца.

textAlignVertical

String

Вертикальное выравнивание текста ячейки. Определяет вертикальное положение текста в ячейке столбца.

textAlignHeaderVertical

String

Вертикальное выравнивание текста заголовка. Определяет вертикальное положение текста в заголовке колонки.

sorter

Boolean

Сортировщие. Активирует сортировку по столбцу.

sorterPreset

String

Предустановка сортировки

Доступные значения:

  • По возрастанию (ASC)

  • По убыванию (DESC)

  • Не установлено (unset)

filtering

String

Поиск. Активирует поиск по данным столбца.

filterTable

Data Table

Фильтр таблицы. Позволяет создавать фильтры для определенного столбца. Вложенная таблица данных с тремя полями:

  • Значение - значение ячейки для фильтрации. Обратите внимание, что если столбец имеет тип полей Boolean, разрешены только значения true или false

  • Описание - описание фильтра

  • Выбран (Boolean)

width

Integer

Width. Ширина столбца, в пикселях.

visibility

Boolean

Видимый. Укажите, должен ли столбец отображаться для пользователя.

index

Integer

Индекс. Укажите начальный порядок столбцов: 0 - самый левый столбец.

Максимальная высота без вертикальной прокрутки

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

Имя переменной:

heightScrollEnabled

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

heightScrollEnabled

Integer

Максимальная высота без вертикальной прокрутки

Включить выбор нескольких строк

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

Имя переменной:

checkRows

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

checkRows

Boolean

Включить выбор нескольких строк

Колонка с режимом только для чтения строки

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

Имя переменной:

columnToDefineRowLock

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

columnToDefineRowLock

String

Колонка с режимом только для чтения строки

Колонка с включенным дополнительным меню

Имя столбца типа Boolean в таблице. Меню будет активно только в тех строках, где значение этого столбца равно True.

Имя переменной:

columnToDefineKebabLock

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

columnToDefineKebabLock

String

Колонка с включенным дополнительным меню

Разрешить изменение размера столбца

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

Имя переменной:

resizableColumn

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

resizableColumn

Boolean

Разрешить изменение размера столбца

Подтверждение удаления строк

Если включено, действие панели инструментов Удалить ряд потребует подтверждения.

Имя переменной:

confirmActionDelete

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

confirmActionDelete

Boolean

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

Если включено, действие панели инструментов Добавить ряд потребует подтверждения.

Имя переменной:

confirmActionAdd

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

confirmActionAdd

Boolean

Иконка фильтрации

Изображение для иконки фильтрации.

Имя переменной:

filterIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

filterIcon

Data Block

Иконка фильтрации

Иконка поиска

Изображение для иконки поиска.

Имя переменной:

searchIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

searchIcon

Data Block

Иконка поиска

Включить видимость колонок

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

Имя переменной:

enableColumnVisibility

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableColumnVisibility

Boolean

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

Настройки вложенных записей

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

Имя переменной:

treeRecordSettings

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

idColumnName

String

Идентификатор записи Имя столбца

parentIdColumnName

String

Идентификатор родительской записи Имя столбца

indentSize

Integer

Размер отступа

visibleChildren

Integer

Видимые дети

Глубина раскрытия записей

Позволяет автоматически разворачивать вложенные записи на указанную глубину. При установке значения Record Expansion Depth в 1 автоматически открываются все дочерние узлы записей верхнего уровня, при установке значения 2 - все дочерние узлы дочерних записей и так далее.

Имя переменной:

expansionDepth

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

expansionDepth

Integer

Record Expansion Depth

Изображение переключателя(открыт)

Применяется, если в настройках "Вложенные записи" настроено отображение данных вложенных строк. Указанное изображение заменяет стандартное изображение открытого переключателя.

Имя переменной:

openedSwitcherImage

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

imageType

Integer

Тип

  • 0 чтобы указать данные

  • 1 чтобы указать URL

imageData

Data Block

Данные изображения

imageUrl

String

Ссылка на изображение

Изображение переключателя(закрыт)

Применяется, если в настройках "Вложенные записи" настроено отображение данных вложенных строк. Указанное изображение заменяет стандартное изображение закрытого переключателя.

Имя переменной:

closedSwitcherImage

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

imageType

Integer

Тип

  • 0 чтобы указать данные

  • 1 чтобы указать URL

imageData

Data Block

Данные изображения

imageUrl

String

Ссылка на изображение

Включить

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

Имя переменной:

additionalActionEnable

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionEnable

Boolean


Показать в ряд

Имя переменной:

additionalActionShowInRow

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionShowInRow

Boolean


Иконка

Имя переменной:

additionalActionIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionIcon

Data Block

Этот флаг показывает, будет ли компонент "слушать" события Нажатие мыши.

Ширина дополнительной иконки

Имя переменной:

additionalActionWidth

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionWidth

Integer

Ширина в пикселях, которая будет добавлена к контейнеру иконки.

Настройки

Данное свойство позволяет задать настройки элемента Дополнительное действие.

Имя переменной:

additionalActionSettings

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

uid

String

Уникальный ID кнопки дополнительного действия.

desc

String

Описание кнопки.

icon

Data Block

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

iconHover

Data Block

Изображение для кнопки в состоянии Наведение курсора мыши.

iconActive

Data Block

Изображение для кнопки в состоянии Активна.

buttonAction

String

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

  • Edit

  • Delete

  • Cancel

  • Apply

confirm

Boolean

Если включено, действие по кнопке потребует подтверждения.

confirmTitle

String

Текст сообщения подтверждения.

Стиль

Имя переменной:

additionalActionStyle

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionStyle

String

Стиль CSS, который будет применен к элементу Дополнительное действие.