Group Footer Panel
- 2 minutes to read
If enabled, group footers are displayed under each group of rows when a View is grouped. Commonly, these panels are used to display group summaries for particular columns.
Feature | Related Members |
|---|---|
Visibility | The View’s OptionsView.GroupFooters property. |
Content | If you need to display custom information within a group footer panel, handle the OnCustomDrawPartBackground event. If this event is not handled, group footer panels display the group summaries specified. Please refer to the Summaries topic for additional information. |
Appearance | The group footer panels’ look and feel depends on the grid control’s LookAndFeel property settings. The style and background bitmap can be changed using the View’s Styles.Footer and BackgroundBitmaps.Footer properties. If you need to provide different styles for individual footers and footer cells, handle the View’s Styles.OnGetFooterStyle or Styles.OnGetFooterStyleEx event. Table Views and Banded Table Views also allow you to provide custom styles for the footer cells corresponding to a particular column. For this purpose, handle the desired column’s Styles.OnGetFooterStyle and Styles.OnGetFooterStyleEx events. |
Custom Draw | To custom paint the entire group footer panel, handle the View’s OnCustomDrawPartBackground event. The event’s AViewInfo parameter is of the TcxGridRowFooterViewInfo type if a group footer panel is about to be painted. If you need to custom paint group footer cells, you can handle either the View’s OnCustomDrawFooterCell event or the desired column’s OnCustomDrawFooterCell event. |
Layout | A group footer panel’s height depends on the style (font settings, in particular) assigned. If the View’s OptionsView.FooterAutoHeight option is enabled group footer panels are automatically enlarged vertically when a summary value’s text doesn’t fit into the footer cells. |