OptionsNavPane.AllowOptionsMenuItem Property

Gets or sets whether an end-user can invoke the Navigation Pane Options dialog to customize the order of groups and font settings of items.

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v24.1.dll

NuGet Packages: DevExpress.Win, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(false)]
public virtual bool AllowOptionsMenuItem { get; set; }

VB.NET

<DefaultValue(False)>
Public Overridable Property AllowOptionsMenuItem As Boolean

Property Value

Type	Default	Description
Boolean	false	true if an end-user can invoke the Navigation Pane Options Dialog; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AllowOptionsMenuItem
NavBarControl	.OptionsNavPane .AllowOptionsMenuItem

Remarks

If the AllowOptionsMenuItem property is set to true, the Navigation Pane Customization Menu contains a Navigation Pane Options… menu command. This command invokes the Navigation Pane Options dialog allowing an end-user to change the order of groups and font settings of items:

For groups displaying custom controls (when their NavBarGroup.GroupStyle properties are set to NavBarGroupStyle.ControlContainer), the Font button in the Navigation Pane Options dialog is disabled by default. To enable this button and allow an end-user to customize a font for this group, handle the NavBarControl.NavPaneOptionsCanEditGroupFont event. After the user selected a font via a separate dialog, you can apply this font to the group according to custom logic via the NavBarControl.NavPaneOptionsApplyGroupFont event.