Общие свойства
В этом разделе описываются свойства компонента Таблица данных, общие для всех унаследованных компонентов.
Показать строку поиска
Если включено, позволяет осуществлять поиск по журналу событий.
Имя переменной: | 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 | Должно возвращать булево значение. Выполняется для каждой строки таблицы данных. Выражение выполняется при каждом изменении таблицы.
| |
Среда вычисления выражения выбора строк: | |||
Таблица данных компонента | |||
Нет. | |||
Текущая обрабатываемая строка таблицы данных по умолчанию | |||
Только Стандартные переменные. |
Настройки столбцов
Данное свойство включает различные настройки визуального представления и поведения столбцов таблицы.
Имя переменной: | columnsSettings |
Записи: | 0..не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
name | String | Имя. Имя столбца. |
fixed | String | Фиксированная Колонка. |
headerTextBehavior | String | Поведение текста заголовка. |
wordBreak | String | Перенос строк. Определяет поведение переноса строки, если текст выходит за пределы ячейки столбца. |
visibleLength | Integer | Видимая длина. Определяет максимальное количество символов строки для отображения. Полное значение будет отображаться во всплывающей подсказке при наведении мыши. |
textAlignHorizontal | String | Горизонтальное выравнивание текста ячейки. Определяет горизонтальное положение текста в ячейке столбца. |
textAlignHeaderHorizontal | String | Горизонтальное выравнивание текста заголовка. Определяет горизонтальное положение текста в заголовке столбца. |
textAlignVertical | String | Вертикальное выравнивание текста ячейки. Определяет вертикальное положение текста в ячейке столбца. |
textAlignHeaderVertical | String | Вертикальное выравнивание текста заголовка. Определяет вертикальное положение текста в заголовке колонки. |
sorter | Boolean | Сортировщие. Активирует сортировку по столбцу. |
sorterPreset | String | Предустановка сортировки Доступные значения:
|
filtering | String | Поиск. Активирует поиск по данным столбца. |
filterTable | Data Table | Фильтр таблицы. Позволяет создавать фильтры для определенного столбца. Вложенная таблица данных с тремя полями:
|
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 | Тип
|
imageData | Data Block | Данные изображения |
imageUrl | String | Ссылка на изображение |
Изображение переключателя(закрыт)
Применяется, если в настройках "Вложенные записи" настроено отображение данных вложенных строк. Указанное изображение заменяет стандартное изображение закрытого переключателя.
Имя переменной: | closedSwitcherImage |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
imageType | Integer | Тип
|
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 | Определяет, какое действие будет выполняться для соответствующего ряда путем нажатия на кнопку. Свойство имеет несколько допустимых значений:
|
confirm | Boolean | Если включено, действие по кнопке потребует подтверждения. |
confirmTitle | String | Текст сообщения подтверждения. |
Стиль
Имя переменной: | additionalActionStyle |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
additionalActionStyle | String | Стиль CSS, который будет применен к элементу Дополнительное действие. |