Skip to main content

TcxGridColumnStyles.OnGetFooterStyleEx Event

Occurs when the column footer should be redrawn.

Declaration

property OnGetFooterStyleEx: TcxGridGetFooterStyleExEvent read; write;

Remarks

The OnGetFooterStyleEx event occurs every time the column footer is redrawn and is fired after the OnGetFooterStyle event.

By default, the AStyle parameter at the moment the OnGetFooterStyleEx event is fired represents the style which was returned by the procedure that handles the OnGetFooterStyle event (if any). To specify the style for a footer region you can create a TcxStyle object instance, adjust its properties as required and return it via the AStyle parameter.

The Sender, ARow, and AColumn parameters identify the View, row, and column, respectively for which the footer region is drawn. When handling the OnGetFooterStyleEx event, you can distinguish between the View footer and group footers by comparing the ARow parameter’s value with nil. For View footers, it will always return nil. For group footers, the ARow parameter will specify the last data record/row within the corresponding group.

The AFooterGroupLevel parameter corresponds to the data group, for which the footer region is drawn (it’s equal to the group column’s GroupIndex property’s value). For View footers, the AFooterGroupLevel value is -1.

To define the default styles for the footer regions of all the columns in the View, use the View’s Styles.Footer, Styles.OnGetFooterStyle and Styles.OnGetFooterStyleEx members.

Note

The column’s OnGetFooterStyleEx and OnGetFooterStyle events override the default style for the column footer stored in the column’s Styles.Footer property. The latter in turn overrides any style which is returned from the View’s Styles.OnGetFooterStyleEx and Styles.OnGetFooterStyle events, which in turn override the style stored in the View’s Styles.Footer property.

See Also