TdxNavBarGroupViewInfo.CaptionStyle Method

Provides access to the default style settings of the group header.

Declaration

function CaptionStyle: TdxNavBarBaseStyle; virtual;

Returns

Type
TdxNavBarBaseStyle

Remarks

The CaptionStyle property returns the default style assigned to the group header with respect to its state. Thus it can return either the OptionsStyle.DefaultStyles.GroupHeader, OptionsStyle.DefaultStyles.GroupHeaderActive, OptionsStyle.DefaultStyles.GroupHeaderHotTracked or OptionsStyle.DefaultStyles.GroupHeaderPressed styles.

Use this property when handling the OnCustomDraw.GroupCaption event. You can change property values of the object returned via this property to change the look & feel of group headers. Using this technique is an alternative to specifying custom styles for each group of the NavBar control. Moreover, this enables you to apply various styles to group headers dynamically.

Note that if you want a group header to be painted in default manner but with modified styles, you should leave the AHandled parameter of the OnCustomDraw.GroupCaption event unchanged (set to False).

Note

this property returns the default style applied to all groups of the NavBar control. Use the CaptionStyleItem property to access the custom style applied to the group.