HamburgerMenu.AllowBuiltInNavigation Property

Gets or sets whether to automatically set the Hamburger Menu content to a NavigationFrame instance, enabling the navigation capability. This is a dependency property.

Namespace: DevExpress.Xpf.WindowsUI

Assembly: DevExpress.Xpf.Controls.v19.2.dll

Declaration

C#

public bool AllowBuiltInNavigation { get; set; }

VB.NET

Public Property AllowBuiltInNavigation As Boolean

Property Value

Type	Description
Boolean	true, to enable navigation by automatically set the menu content to a NavigationFrame; otherwise, false.

Remarks

The AllowBuiltInNavigation property is only in effect if the menu’s Content property is set to null (the default value).

Use the menu item’s HamburgerMenuNavigationButtonBase<TOwner>.NavigationTargetType/HamburgerMenuNavigationButtonBase<TOwner>.NavigationTargetTypeName property to specify the page to be opened when an end-user clicks the menu item. However, to enable this functionality, you should do one of the following:

• Leave the menu’s Content property unspecified and set the AllowBuiltInNavigation property to true
• Manually specify the NavigationFrame as the root element of the menu’s content
• Set the HamburgerMenu.NavigationTarget property to a NavigationFrame or a FrameNavigationService

Important

If both the HamburgerMenu.NavigationTarget and Content properties are set to a valid value, the HamburgerMenu.NavigationTarget property will be prioritized.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AllowBuiltInNavigation property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

wpf-hamburger-menu-with-mvvm/VB/Hamburger/MainWindow.xaml#L19

</Window.Resources>
<dxwui:HamburgerMenu IsMenuVisible="{Binding IsMenuVisible}" ItemsSource="{Binding Items}" AllowBuiltInNavigation="True"
                     SelectedItem="{Binding SelectedItem, Mode=TwoWay}" ItemTemplate="{StaticResource HamburgerMenuItemTemplate}" >