AnalyticalGrid#
Контрол, представляющий собой нередактируемую таблицу, предназначенную для навигации и отображения данных.
В отличие от контрола Grid, в AnalyticalGrid отсутствуют:
- свойство readOnly
- событие cellValueChanged
- обработка нажатий клавиш "вниз", "delete" и "ctrl+insert".
Свойства#
adminCustomizable#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | true | true/false |
Включает режим настраиваемости грида для администратора.
Работает по аналогии со свойством customizable, но дополнительно сохраняются группировки строк. Если свойство включено, то у администротора появлятеся кнопка сохранения состояния грида. Сохраненное состояние распространяется на всех пользователей. Собственные настройки пользователя являются более приоритетными.
allowUserToExportRows#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | true | true/false |
Включает экспорт строки в грид.
Параметр, отвечающий за возможность пользовательского экспорта строк в грид (постановка)
autoHeight#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Настройка автовысоты грида.
bind#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - |
Свойство, к которому биндится контрол.
caption#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string |
Заголовок контрола.
captionWidth#
Ширина заголовка в колонках (для Bootstrap-верстки).
Отнаследовано от Control.
columnsHeight#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - |
Высота заголовка колонок.
columnsReorder#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Возможность изменения порядка колонок пользователем.
columnsResize#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Возможность изменения ширины колонок грида.
customizable#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Включает режим настраиваемости, управление набором колонок и сохранение состояния грида между сеансами.
dataSource#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - | - |
Источник данных грида.
denyRoles#
Список ролей без прав на данный элемент.
Отнаследовано от Control.
editorWidth#
Ширина контрола в колонках (для Bootstrap-верстки).
Отнаследовано от Control.
exportCaption#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string |
Свойство, устанавливающее заголовок таблицы при экспорте грида в Excel.
filterable#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Возможность фильтрации.
groupable#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Возможность группировки.
groupsExpandedByDefault#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | true | true/false |
Настройка групп по умолчанию в развернутом состоянии.
height#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| int | 400 |
Высота контрола в пикселях.
hint#
Всплывающая подсказка, которая появляется при наведении на контрол.
Отнаследовано от Control.
id#
Идентификатор контрола.
Отнаследовано от Control.
readRoles#
Список ролей на чтение данных.
Отнаследовано от Control.
selectionMode#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | checkbox | true/false |
Режим выделения.
showAggregates#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | афдыу | true/false |
Отображение суммовых полей.
showFilterMenuItems#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | афдыу | true/false |
Флаг вызова окна с настройками фильтров.
Включить/выключить возможность вызывать окно с настройками фильтров. Этот функционал становится недоступным (является взаимоисключающим свойством с showFilterRow), если в гриде включено отображение строки фильтра. Окно фильтрации открывается нажатием на кнопку сортировки, которая отображается рядом с заголовком колонки при наведении на него курсора.
showFilterRow#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Отображение полей фильтрации.
showGridInfo#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | true | true/false |
Отображение информации о выделенных, отфильтрованных строках.
showStatusBar#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Отображение поля для суммовых полей.
sortable#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Возможность сортировки.
sortColumn#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - | - |
Колонка для сортировки по умолчанию.
sortDirection#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | asc | asc/desc |
Направление сортировки по умолчанию.
statusBarHeight#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| int |
Высота суммовых полей.
tags#
Позволяет объединять контролы в группы, возвращает массив имен.
Отнаследовано от Control.
toolbarVisible#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | true | true/false |
Отображение кнопок грида.
visible#
Видимость контрола.
Отнаследовано от Control.
width#
Ширина контрола.
Отнаследовано от Control.
writeRoles#
Список ролей на изменение данных.
Отнаследовано от Control.
Свойства управления навигацией#
AnalyticalGrid имеет ряд свойств, позволяющих управлять механизмом навигации (ссылками в ячейках грида):
disableNavigation#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | true | true/false |
Флаг, регулирующий создание ссылок.
Примечание
При disableNavigation = true ссылки в гриде не создадутся
primaryKeyName#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | VCode | true/false |
Имя первичного ключа.
useCustomLinkRenderer#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| bool | false | true/false |
Флаг, регулирующий использование функции частного построения ссылок.
viewName#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - | - |
Имя экранной формы.
Навигационные ссылки создаются с заданными настройками при открытии формы. Для повторного создания ссылок (в случае изменения настроек) нужно вызвать метод грида render().
Методы#
См. методы в контроле Grid.
События#
rowSelected#
Срабатывает при выделении строки.
rowUnselected#
Срабатывает при снятии выделения строки.
rowClicked#
Срабатывает при клике по строке.
cellClicked#
Срабатывает при клике по ячейке.
rowDoubleClicked#
Срабатывает при двойном клике по строке.
cellDoubleClicked#
Срабатывает при двойном клике по ячейке.
rowExpanded#
Срабатывает при раскрытии вложенного грида.
linkRenderer#
Срабатывает при генерации ссылки в ячейки.
Основная статья: Grid (linkrenderer)
- Отличие данного от linkRenderer колонки заключается в том, что свойство text возвращаемого объекта не учитывается.
- Если задать обработчик linkRenderer колонки в аналитическом гриде, то linkRenderer грида будет перекрывать соответствующий обработчик колонки
cellPainter#
Срабатывает при отрисовке ячейки.
Основная статья: Grid (cellpainter).
События колонки#
См. методы колонок в Grid (События колонки).