TcxCustomGridTableItem.GroupIndex Property

Specifies the group index of the item (column).

Declaration

property GroupIndex: Integer read; write; default -1;

Property Value

Type
Integer

Remarks

Grouping is only implemented in Table Views and Banded Table Views. Use the GroupIndex property to group data by the View’s current column. If GroupIndex is set to -1, then data is not grouped by the column. Otherwise, GroupIndex specifies the position of the column amongst the other group columns.

To control the visibility state of an item (column) within a View, use the column’s Visible property.

To prevent an end-user from grouping/ungrouping data by the column,

• set the column’s Options.Grouping property to False

• set the View’s OptionsCustomize.ItemGrouping property (OptionsCustomize.ColumnGrouping in a Table View) to False

The TcxDataControllerGroups class implements grouping operations on data in a data controller. You can address a specific group by the index of the row it contains and then get the summary values calculated against this group via TcxDataSummary.GroupSummaryValues, for instance. You can access TcxDataControllerGroups class functionality via the View’s DataController.Groups object.

The default value of the GroupIndex property is -1.