Skip to main content

HamburgerMenu.SyncWithActivePage Property

Gets or sets whether the button selection in the menu is automatically synchronized with the navigated page.

Namespace: DevExpress.UI.Xaml.Layout

Assembly: DevExpress.UI.Xaml.Layout.v21.2.dll

NuGet Package: DevExpress.Uwp.Controls

Declaration

public bool SyncWithActivePage { get; set; }

Property Value

Type Description
Boolean

true, if the button selection in the menu is automatically synchronized with the navigated page; otherwise, false. The default is true.

Remarks

The button currently selected in the menu (see HamburgerMenu.SelectedItem) is automatically synchronized with the navigated page. This means that when an end-user navigates to a page, the corresponding button (the button that has the same navigation target page as the page being navigated) is automatically selected in the menu. If the menu does not contain the corresponding button, no button is selected. By default, this feature is enabled. Set the SyncWithActivePage property to false to disable this automatic synchronization.

To disable this feature for a particular button, use the HamburgerMenuNavigationButton.SyncWithActivePage or HamburgerSubMenuNavigationButton.SyncWithActivePage property.

The synchronization is performed based on the button’s navigation target page and the page being navigated. The navigation parameters are not taken into account for the synchronization, by default. Enable the HamburgerMenuNavigationButton.UseNavigationTargetParameterForSync or HamburgerSubMenuNavigationButton.UseNavigationTargetParameterForSync option for the corresponding button to perform the automatic synchronization according to the button’s navigation parameters.

See Also