Skip to main content

Footer Panel

  • 2 minutes to read

Footer panels are displayed at the bottom of table and Banded Table Views. Commonly, such panels are used to display total summaries (also called footer summaries), but you can also display any custom information you need.

Feature

Related Members

Visibility

The View’s OptionsView.Footer property.

Content

If you need to display custom information within the footer panel, handle the OnCustomDrawPartBackground event. If this event is not handled, the footer panel displays the total summaries specified. Please refer to the Summaries topic for additional information.

Appearance

The footer panel’s look and feel depends upon the grid control’s LookAndFeel property settings. The panel’s style and background bitmap can be changed using the View’s Styles.Footer and BackgroundBitmaps.Footer properties. Note that these properties affect both the footer panel and group footer panels. If you need to provide a unique style for the footer panel only, handle the View’s Styles.OnGetFooterStyle event. The event’s ARecord parameter is nil if the footer panel is being processed. Note that this event also enables you to set styles for the footer panel’s cells.

Custom Draw

Handle the View’s OnCustomDrawPartBackground event. The event’s AViewInfo parameter is of the TcxGridFooterViewInfo type if the footer panel is about to be painted.

If you need to custom paint footer cells, you can handle either the View’s OnCustomDrawFooterCell event or the desired column’s OnCustomDrawFooterCell event.

Layout

The footer panel’s height depends on the style (font settings, in particular) that is assigned. If the View’s OptionsView.FooterAutoHeight option is enabled the footer panel is automatically enlarged vertically when a summary value’s text doesn’t fit into the footer cells.