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

OfficeNavigationBar.CustomizationButtonVisibility Property

Gets or sets the visibility and position of the Customization Button (OffNavBar-CustomizationButton.png).

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(CustomizationButtonVisibility.Default)]
[DXCategory("Appearance")]
public CustomizationButtonVisibility CustomizationButtonVisibility { get; set; }

#Property Value

Type Default Description
DevExpress.XtraBars.Navigation.CustomizationButtonVisibility Default

The Customization Button’s visibility and position.

#Remarks

The default behavior of the Customization Button is to show a context menu containing the Navigation Options command when the button is clicked or right-clicked:

OfficeNavigationBar-CustomizationButton-Menu.png

Selecting this command invokes a Navigation Options dialog that allows an end-user to re-order items and specify the number of visible items. This dialog can be invoked in code with the OfficeNavigationBar.ShowNavigationOptionsDialog method. To prevent the Navigation Options dialog from being invoked or to customize the context menu, handle the OfficeNavigationBar.PopupMenuShowing event.

The CustomizationButtonVisibility property can be set to the following values:

Default

The Customization button is hidden in the Tab view mode (see OfficeNavigationBar.ViewMode). The button is displayed after items in other view modes.

Hidden

The button is hidden.

ShowBeforeItems

The button is displayed before items.

ShowAfterItems

The button is displayed after items.

See Also