Skip to main content

TcxGridColumnStyles.OnGetFooterStyle Event

Occurs when the column footer should be redrawn.

Declaration

property OnGetFooterStyle: TcxGridGetCellStyleEvent read; write;

Remarks

The OnGetFooterStyle event occurs every time the column footer is redrawn.

The style returned by the column’s OnGetFooterStyle event overrides the default style for the columns footer which is stored in the column’s Styles.Footer property. This in turn overrides any style returned from the View’s Styles.OnGetFooterStyle event which in turn overrides the style stored in the View’s Styles.Footer property.

To specify the style for a footer region you have to create a TcxStyle object instance, adjust its properties as necessary and return it via the AStyle parameter.

The Sender and AItem parameters identify a View and a column respectively for which the footer region is drawn.

When View data is grouped the ARecord parameter refers to the last record in a group. When data is not grouped it is nil.

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

The OnGetFooterStyleEx event represents the extended version of the OnGetFooterStyle event and should be handled whenever you need to perform additional style customizations of the grouped items in the View.

Note

The column’s OnGetFooterStyle and OnGetFooterStyleEx events override the default style of the column footer which is stored in the column’s Styles.Footer property. The latter in its 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