Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

Group By Box

The Group By box displays the headers of the columns that are involved in grouping (if any). This box also enables users to group a View’s data by serving as a drop target for column headers. If enabled, this box is displayed at the top of the View.

VCL Data Grid: A Group By Box Example

Feature

Related Members

Visibility

The View’s OptionsView.GroupByBox property.

Content

If the View is grouped, the Group By box displays the headers of the columns involved in grouping.

You can customize the caption of columns displayed in the dialog via their AlternateCaption property.

Appearance

The style and background bitmap can be changed using the View’s Styles.GroupByBox and BackgroundBitmaps.GroupByBox properties. If you need to manually paint the Group By box, handle the View’s OnCustomDrawPartBackground event.

Custom Draw

The View’s OnCustomDrawPartBackground event. The event’s AViewInfo parameter is of the TcxGridGroupByBoxViewInfo type if the Group By box is about to be painted.

See Also