Implementing Syncfusion WinForms MainFrameBarManager

When to Use This Skill

The MainFrameBarManager component is essential when you need to:

Create hierarchical menu structures (File, Edit, View menus with submenus)
Build customizable toolbars and command bars
Add keyboard shortcuts and mnemonics to menu items
Implement context menus and interactive tooltips
Support MDI (Multiple Document Interface) applications with merged menus
Persist menu and toolbar state between application sessions
Enable end-users to customize menu layout at runtime

This component follows the XP Menus Framework pattern, providing a professional, enterprise-grade menu management system for Windows Forms applications.

Quick Start Example

// Create MainFrameBarManager
MainFrameBarManager mainFrameBarManager1 = new MainFrameBarManager();
mainFrameBarManager1.Style = Syncfusion.Windows.Forms.VisualStyle.Office2016Colorful;
mainFrameBarManager1.Form = this;

// Create a bar (menu container)
Bar fileBar = new Syncfusion.Windows.Forms.Tools.XPMenus.Bar();
fileBar.BarName = "File";
fileBar.Caption = "File";
fileBar.Manager = mainFrameBarManager1;

// Create parent menu item
ParentBarItem fileMenu = new ParentBarItem();
fileMenu.Text = "&File";

// Create sub-menu items
BarItem newItem = new BarItem() { Text = "&New" };
BarItem openItem = new BarItem() { Text = "&Open" };
BarItem exitItem = new BarItem() { Text = "E&xit" };

// Assign shortcuts and mnemonics
newItem.Shortcut = Shortcut.CtrlN;
openItem.Shortcut = Shortcut.CtrlO;
exitItem.Shortcut = Shortcut.AltF4;

// Build hierarchy
fileMenu.Items.AddRange(new BarItem[] { newItem, openItem, exitItem });
fileBar.Items.Add(fileMenu);

// Add to manager
mainFrameBarManager1.Items.AddRange(new BarItem[] { fileMenu, newItem, openItem, exitItem });
mainFrameBarManager1.Bars.Add(fileBar);
mainFrameBarManager1.Categories.Add("Menu");

Common Patterns

Pattern 1: Creating Multi-Level Menus

Create nested ParentBarItems for submenus (File → Recent → Document1). Group related items under parent containers.

Pattern 2: Adding Interactive Controls

Use DropDownBarItem with PopupControlContainer for color pickers, ComboBoxBarItem for selections, TextBoxBarItem for input fields.

Pattern 3: Implementing Customization

Enable AutoPersistCustomization to allow users to rearrange menu items and save their preferences automatically.

Pattern 4: MDI Application Integration

Use MainFrameBarManager for parent forms and ChildFrameBarManager for child forms. Call RegisterMdiChildTypes() for automatic menu merging.

Pattern 5: Keyboard Navigation

Assign Shortcut properties and use & symbol in Text for mnemonics (e.g., "&Save" creates Alt+S).

Key Properties

Property	Type	Purpose
Form	Form	Associates the menu manager with the parent form
Style	VisualStyle	Sets the visual style (Office2016, XPBlue, etc.)
Bars	BarCollection	Collection of Bar instances (menus, toolbars)
Items	BarItemCollection	All BarItem instances managed by this manager
Categories	StringCollection	Categories for organizing menu items in customization UI
AutoLoadToolBarPositions	bool	Auto-loads saved toolbar positions on startup
AutoPersistCustomization	bool	Auto-saves menu and toolbar customizations
DetachedCommandBars	CommandBarCollection	Collection of detachable CommandBar instances