NavBarControl.NavPaneOptionsCanEditGroupFont Event

Allows you to specify whether an end-user can edit font settings for individual groups via the Navigation Pane Options dialog.

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v20.1.dll

Declaration

public event EventHandler<NavPaneOptionsCanEditGroupFontEventArgs> NavPaneOptionsCanEditGroupFont
Public Event NavPaneOptionsCanEditGroupFont As EventHandler(Of NavPaneOptionsCanEditGroupFontEventArgs)

Event Data

The NavPaneOptionsCanEditGroupFont event's data class is DevExpress.XtraNavBar.NavPaneOptionsCanEditGroupFontEventArgs.

Remarks

An end-user can edit font settings of individual groups via the Navigation Pane Options dialog, which is available if the OptionsNavPane.AllowOptionsMenuItem property is set to true.

NavPaneOptionsDialog1

Font settings of NavBar groups can be edited by clicking the Font button in the Navigation Pane Options dialog.

For regular groups (whose NavBarGroup.GroupStyle properties are not set to NavBarGroupStyle.ControlContainer), the Font button is enabled by default.

For groups displaying custom controls (when their NavBarGroup.GroupStyle properties are set to NavBarGroupStyle.ControlContainer), the Font button is disabled by default.

To specify whether the Font button is enabled or not for individual groups, you can handle the NavPaneOptionsCanEditGroupFont event.

If the Font button is enabled, an end-user can click it to invoke the Font dialog and change font settings. After selecting a new font and closing the Navigation Pane Options dialog, the font is automatically applied to items within regular groups. For groups displaying custom controls, the font is not automatically applied. You can apply a font to these groups manually via the NavBarControl.NavPaneOptionsApplyGroupFont event. Note that the NavBarControl.NavPaneOptionsApplyGroupFont event also fires for regular groups after the font settings of items have been changed.

NOTE

Enable the NavBarLayoutOptions.StoreAppearance option (via the NavBarControl.OptionsLayout property) to save font settings when saving the control's layout and restore these settings when loading the layout.

See Also