1.4.6. Клиентская группировка¶

1.4.6.1. Общие сведения¶

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

После этого, на эту панель можно перетащить заголовок столбца, по которому необходимо задать группировку.

Также в табличных фреймах есть возможность задать группировку по нескольким столбцам, с указанием порядка группировки

1.4.6.2. Управление клиентской группировкой из скриптера¶

Управление клиентской группировкой из скриптера осуществляется с помощью следующих методов:

TbtkScriptControllerObject.GroupsVisible - Свойство управляет видимостью области группировки
TbtkScriptControllerObject.GroupsFootersVisible - Свойство управляет видимостью области итогов для группирвки
TbtkScriptControllerObject.GroupsAddField - Метод добавляет атрибут с именем FieldName в область группировки. (Атрибут становится невидимым в списке)
TbtkScriptControllerObject.GroupsClear - Метод удаляет все атрибуты из области группировки.
TbtkScriptControllerObject.GroupsCount - Метод возвращает количество атрибутов в области группировки
TbtkScriptControllerObject.GroupsFullExpand - Метод разворачивает все узлы группировок
TbtkScriptControllerObject.GroupsFullCollapse - Метод сворачивает все узлы группировок
TbtkScriptControllerObject.GroupsGetIndex - Метод возвращает порядковый номер атрибута в области группировки. Если атрибут не в обрасти группировки, метод вернёт “-1”
TbtkScriptControllerObject.GroupsRemoveField - Метод удаляет атрибут с именем FieldName из области группировки. (Атрибут становится видимым в списке)

Пример¶

Selection.Controller.GroupsVisible := True;
Selection.Controller.GroupsAddField('sUserCreated');
Selection.Controller.GroupsAddField('nPriority');
Selection.Controller.GroupsFullExpand;