[]
        
(Showing Draft Content)

Expansion State

Expansion applies at three levels.

Level

Property

Description

Menu

C1HamburgerMenu.IsExpanded

Determines whether the menu uses its expanded or collapsed layout.

Parent item

C1HamburgerMenuItem.Expanded

Determines whether a parent item displays its child items.

Item capability

C1HamburgerMenuItem.Expandable

Determines whether an item can display child items.

ExpandedMode and CollapsedMode define appearance and layout behavior. They don't change the expansion state. Set IsExpanded directly, or let users select the toggle button.


Expanded Modes

ExpandedMode determines how the menu behaves when it's expanded.

Value

Description

Demo

Overlay

Displays the expanded menu over application content.

C1WinForms Hamburger Menu - Overlay expansion state

PushContent

Repositions application content while the menu is expanded.

C1WinForms Hamburger Menu - PushContent expansion state

Always

Keeps the menu expanded

C1WinForms Hamburger Menu - Always expansion state

Choose a mode based on how the application uses the space next to the menu:

  • Use Overlay when the menu can temporarily cover content.

  • Use PushContent when the menu and application content must remain visible together.

  • Use Always for permanent navigation, or when a search panel must remain visible with the menu.


Collapsed Modes

CollapsedMode determines how the menu appears when it's collapsed.

Value

Description

Demo

IconsOnly

Displays item icons without text.

C1WinForms Hamburger Menu - Icon collapse mode

Minimal

Displays the menu in a reduced layout.

C1WinForms Hamburger Menu - Minimal collapse mode

Hidden

Hides the menu.

C1WinForms Hamburger Menu - Hidden collapse mode

IconsOnly requires visible items to have icons. When you use Hidden, provide another command that sets IsExpanded to true.

Use CollapsedWidth and ExpandedWidth to configure the dimensions for each state.