HamburgerSubMenu Class

Represents a button with an icon in the HamburgerMenu that provides access to a Sub Menu.

Namespace: DevExpress.Xpf.WindowsUI

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

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Controls, DevExpress.Wpf.Navigation

Declaration

C#

public class HamburgerSubMenu :
    ContentControl,
    IHamburgerMenuItem,
    IHamburgerMenuItemBase,
    IVisualItem,
    ISupportStandaloneSelection,
    ISupportSelection,
    ISupportOwner<HamburgerMenu>,
    IGlyphElement,
    IHamburgerMenuFlyoutItem

VB.NET

Public Class HamburgerSubMenu
    Inherits ContentControl
    Implements IHamburgerMenuItem,
               IHamburgerMenuItemBase,
               IVisualItem,
               ISupportStandaloneSelection,
               ISupportSelection,
               ISupportOwner(Of HamburgerMenu),
               IGlyphElement,
               IHamburgerMenuFlyoutItem

Remarks

The HamburgerSubMenu control is a button in the HamburgerMenu that invokes a flyout panel with a click. Use the HamburgerMenu.Items collection to add the HamburgerSubMenu to the HamburgerMenu.

The flyout panel displays items of the sub menu. To specify the collection of sub-menu items, use the HamburgerSubMenu.Items property.

You can display sub menu items in a preview directly in the main menu below the sub menu button. To add a sub menu item to the preview, set its HamburgerSubMenuNavigationButton.ShowInPreview property to true.

The markup below illustrates how to implement a HamburgerMenu with a sub menu.

XAML

<dx:ThemedWindow x:Class="DXApplication1.MainWindow"
                 xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
                 xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                 xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
                 xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
                 xmlns:dxwui="http://schemas.devexpress.com/winfx/2008/xaml/windowsui"
                 xmlns:dxwuin="http://schemas.devexpress.com/winfx/2008/xaml/windowsui/navigation"
                 mc:Ignorable="d"
                 Title="MainWindow">
    <dxwui:HamburgerMenu>
        <dxwui:HamburgerSubMenu Content="Menu" Glyph="Icons/Menu.png">
            <dxwui:HamburgerSubMenu.Items>
                <dxwui:HamburgerSubMenuNavigationButton Content="MenuSubItem 1" PreviewContent="PreviewItem 1" ShowInPreview="True" SelectOnClick="False" RightContent="RC"/>
                <dxwui:HamburgerSubMenuNavigationButton Content="MenuSubItem 2" PreviewContent="PreviewItem 2" ShowInPreview="True" SelectOnClick="False"/>
                <dxwui:HamburgerSubMenuNavigationButton Content="MenuSubItem 3"/>
                <dxwui:HamburgerSubMenuNavigationButton Content="MenuSubItem 4" ShowPreviewMark="True"/>
            </dxwui:HamburgerSubMenu.Items>
        </dxwui:HamburgerSubMenu>
    </dxwui:HamburgerMenu>
</dx:ThemedWindow>

Related GitHub Examples

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

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.

XAML

wpf-mvvm-behaviors-hamburger-based-theme-selector/CS/HamburgerSubMenuThemeSelectorBehavior/MainWindow.xaml#L13

<dxwui:HamburgerMenu>
    <dxwui:HamburgerSubMenu>
        <dxmvvm:Interaction.Behaviors>

Inheritance

Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement

Control

ContentControl

HamburgerSubMenu