Menus & Navigation

Menu bars, context menus, toolbars, ribbons, side/nav bars, tabs, breadcrumbs, steppers and app bars — the chrome that moves the user around the app. Each derives its native WPF primitive and layers on Beep theming and skinning.

The menu / navigation family is a SimpleItem family. A menu is a "list of values", so these controls expose their items as ListItems — an IEnumerable of SimpleItem that forwards to the inherited ItemsSource — and render each row through BeepListItem. The true menu controls (BeepMenuBar, BeepContextMenu, BeepFlyoutMenu) additionally offer a WinForms-parity IList<SimpleItem> MenuItems collection whose backing store is the control's ItemsSource, so adding to it renders immediately.

On this page

BeepMenuBar

A top-level menu bar of SimpleItem menus with cascading sub-items.

Base type: System.Windows.Controls.Menu. Also exposes a WinForms-parity IList<SimpleItem> MenuItems whose backing store is ItemsSource.
PropertyTypeDescription
ListItemsIEnumerableMenu source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepMenuBar ListItems="{Binding TopMenus}"/>

BeepContextMenu

A right-click context menu populated from SimpleItems.

Base type: System.Windows.Controls.ContextMenu, implements IBeepThemeable. Also exposes IList<SimpleItem> MenuItems.
PropertyTypeDescription
ListItemsIEnumerableMenu source (SimpleItem); forwards to ItemsSource.
 
<Grid>
    <Grid.ContextMenu>
        <beep:BeepContextMenu ListItems="{Binding RowActions}"/>
    </Grid.ContextMenu>
</Grid>

BeepContextMenuStrip

A strip-style menu of SimpleItem commands (WinForms ContextMenuStrip parity) usable as an inline command bar.

Base type: System.Windows.Controls.ItemsControl.
PropertyTypeDescription
ListItemsIEnumerableCommand source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepContextMenuStrip ListItems="{Binding Commands}"/>

BeepFlyoutMenu

A flyout/popup menu of SimpleItems anchored to a trigger element.

Base type: System.Windows.Controls.ContextMenu, implements IBeepThemeable. Also exposes IList<SimpleItem> MenuItems.
PropertyTypeDescription
ListItemsIEnumerableMenu source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepFlyoutMenu ListItems="{Binding QuickActions}"/>

BeepToolBar

A toolbar of SimpleItem command buttons.

Base type: System.Windows.Controls.ToolBar.
PropertyTypeDescription
ListItemsIEnumerableCommand source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepToolBar ListItems="{Binding ToolbarCommands}"/>

BeepRibbon

An Office-style ribbon container (tabs of grouped commands) presented as content.

Base type: System.Windows.Controls.ContentControl. The ribbon's tabs/groups are supplied through its inherited Content.
PropertyTypeDescription
BorderRadiusCornerRadiusCorner radius of the ribbon's outer chrome.
 
<beep:BeepRibbon BorderRadius="6">
    <!-- ribbon tabs / groups -->
</beep:BeepRibbon>

BeepNavBar

A horizontal navigation bar of SimpleItem destinations.

Base type: System.Windows.Controls.ItemsControl, implements IBeepThemeable.
PropertyTypeDescription
ListItemsIEnumerableDestination source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepNavBar ListItems="{Binding NavItems}"/>

BeepSideMenu

A vertical (collapsible) side navigation menu of SimpleItems.

Base type: System.Windows.Controls.ItemsControl.
PropertyTypeDescription
ListItemsIEnumerableMenu source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepSideMenu ListItems="{Binding SideItems}"/>

BeepAccordionMenu

An accordion navigation menu — expandable SimpleItem groups with child items.

Base type: System.Windows.Controls.ItemsControl.
PropertyTypeDescription
ListItemsIEnumerableGroup source (SimpleItem with children); forwards to ItemsSource.
 
<beep:BeepAccordionMenu ListItems="{Binding MenuGroups}"/>

BeepTabControl

A tab control whose tabs are driven from SimpleItems.

Base type: System.Windows.Controls.TabControl.
PropertyTypeDescription
ListItemsIEnumerableTab source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepTabControl ListItems="{Binding Tabs}"/>

BeepBreadcrumb

A breadcrumb trail of SimpleItem path segments.

Base type: System.Windows.Controls.ContentControl.
PropertyTypeDescription
ListItemsIEnumerablePath-segment source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepBreadcrumb ListItems="{Binding PathSegments}"/>

BeepStepperBar

A horizontal stepper/wizard progress bar of SimpleItem steps.

Base type: System.Windows.Controls.ContentControl.
PropertyTypeDescription
ListItemsIEnumerableStep source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepStepperBar ListItems="{Binding WizardSteps}"/>

BeepStepperBreadCrumb

A hybrid stepper rendered as a breadcrumb trail — SimpleItem steps shown as a clickable path.

Base type: System.Windows.Controls.ItemsControl, implements IBeepThemeable.
PropertyTypeDescription
ListItemsIEnumerableStep source (SimpleItem); forwards to ItemsSource.
 
<beep:BeepStepperBreadCrumb ListItems="{Binding WizardSteps}"/>

BeepAppBar

A top application bar (title, actions) presented as themed content.

Base type: System.Windows.Controls.ContentControl. It registers no own DependencyProperties — supply its title/actions through the inherited Content; chrome comes from ControlStyle / Theme. 
<beep:BeepAppBar ControlStyle="Material3">
    <!-- title + action buttons -->
</beep:BeepAppBar>

BeepWebHeaderAppBar

A web-style header app bar (brand, nav, actions) presented as themed content.

Base type: System.Windows.Controls.ContentControl. It registers no own DependencyProperties — supply its header layout through the inherited Content; chrome comes from ControlStyle / Theme. 
<beep:BeepWebHeaderAppBar ControlStyle="Fluent">
    <!-- brand + nav + actions -->
</beep:BeepWebHeaderAppBar>