Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxNavBarGroupViewInfo.CaptionStyle Method

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

#Declaration

Delphi
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.

See Also