TcxGridTableOptionsCustomize.ColumnHidingOnGrouping Property

Indicates whether to hide columns from the View when grouping is applied.

Declaration

property ColumnHidingOnGrouping: Boolean read; write; default True;

Property Value

Type	Default
Boolean	True

Remarks

A grid control enables a user to group data displayed within a View by a column or several columns. Records, which have identical values for grouping columns, are displayed in a single group.

To group by a specific column, the user needs to drag it from the column header panel onto the Group By box. By default, ColumnHidingOnGrouping is True. Thus dragging a column onto the Group By box hides this column (its Visible property is set to False).

If ColumnHidingOnGrouping is False, the column remains within the View when you drag it onto the Group By box (the Visible property value stays True).

When a column is dragged onto the Group By box, its GroupIndex property is set to a value greater than 0 thus determining the position of the column among other grouping columns.

To enable grouping within a View, make certain that the ColumnGrouping property is set to True. It is possible to disable grouping for an individual column via its Options.Grouping property.

See the View’s OptionsView.GroupByBox property to specify the visibility of the Group By box.

Columns invisible within a View can be accessed using the Customization form (the customization form displays those columns which have Visible set to False). You can drag a column from the Customization form on to the column header panel and this will display the column within a View. Dragging a column from the column header panel on to the Customization form hides this column from the View. See the View controller’s Customization property for more information.

The default value of the ColumnHidingOnGrouping property is True.