skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
syncfusion/winforms-ui-components-skills87 installs

syncfusion-winforms-main-frame-bar-manager

Comprehensive guide for implementing Syncfusion MainFrameBarManager menu and toolbar system in Windows Forms. Use when creating menus, toolbars, command bars, or menu structures. Covers hierarchical menu models, BarItem types, interactive features, keyboard support, MDI integration, and state persistence for building professional menu-driven applications with shortcuts, mnemonics, tooltips, and customizable toolbars.

How do I install this agent skill?

npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-main-frame-bar-manager
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides comprehensive documentation and code examples for implementing the Syncfusion WinForms MainFrameBarManager. It covers menu creation, toolbar management, MDI integration, and UI state persistence. The analysis found no evidence of malicious behavior, obfuscation, or high-risk execution patterns. All external references and packages are directed to legitimate vendor resources.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

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

PropertyTypePurpose
FormFormAssociates the menu manager with the parent form
StyleVisualStyleSets the visual style (Office2016, XPBlue, etc.)
BarsBarCollectionCollection of Bar instances (menus, toolbars)
ItemsBarItemCollectionAll BarItem instances managed by this manager
CategoriesStringCollectionCategories for organizing menu items in customization UI
AutoLoadToolBarPositionsboolAuto-loads saved toolbar positions on startup
AutoPersistCustomizationboolAuto-saves menu and toolbar customizations
DetachedCommandBarsCommandBarCollectionCollection of detachable CommandBar instances

Documentation & Navigation Guide

Getting Started

📄 Read: references/getting-started.md

  • NuGet package setup and assembly references
  • Creating MainFrameBarManager instance
  • Setting visual styles and form association
  • License key configuration

Building Menus

📄 Read: references/menu-items-via-code.md

  • Creating Bar instances programmatically
  • Adding BarItem and ParentBarItem
  • Child item hierarchies and sub-menus
  • Event handler setup with code examples

📄 Read: references/menu-items-via-designer.md

  • Designer-based menu creation (drag-and-drop)
  • Customize dialog for bars and items
  • Visual arrangement through UI
  • Automatic assembly reference injection

Menu Item Types & Features

📄 Read: references/menu-item-types.md

  • BarItem (basic clickable items)
  • ParentBarItem (submenu containers)
  • DropDownBarItem (custom popup controls)
  • ComboBoxBarItem (dropdown selections)
  • StaticBarItem (label-like display items)
  • TextBoxBarItem (text input fields)
  • ToolBarListBarItem (toolbar customization options)

Interactive Features

📄 Read: references/interactive-features.md

  • SuperTooltip setup and appearance customization
  • Context menu integration
  • Tooltip visibility control
  • Advanced tooltip editor configuration

Keyboard & Accessibility

📄 Read: references/keyboard-support.md

  • Assigning keyboard shortcuts to menu items
  • Mnemonic text implementation with & symbol
  • ShowMnemonicUnderlinesAlways property
  • Keyboard navigation patterns

State Persistence & MDI

📄 Read: references/state-persistence-mdi.md

  • Enabling state persistence with AutoLoadToolBarPositions
  • Automatic customization serialization
  • MDI parent/child form integration
  • ChildFrameBarManager and menu merging
  • RegisterMdiChildTypes() for explicit merging
  • MDI merge behavior matrix

Detachable Toolbars

📄 Read: references/detachable-command-bars.md

  • CommandBar creation and docking
  • DockState property configuration
  • Adding to DetachedCommandBars collection
  • Designer vs. code-based approaches

Common Use Cases

File Menu: Create a standard File menu with New, Open, Save, Recent Documents, and Exit items using ParentBarItem hierarchy.

Toolbar: Use multiple Bar instances with different BarNames to create separate toolbars, each docked to different positions.

Search Bar: Add TextBoxBarItem or ComboBoxBarItem to toolbar for search/filter functionality.

Color Picker in Menu: Use DropDownBarItem with PopupControlContainer containing ColorPickerUIAdv control.

Localized Menus: Set Text property to localized strings; mnemonics and shortcuts work across all languages.

Custom Shortcuts: Assign Shortcut.None to items without shortcuts, or use custom key combinations via Shortcut enum.

Quick Links

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/syncfusion/winforms-ui-components-skills/syncfusion-winforms-main-frame-bar-manager">View syncfusion-winforms-main-frame-bar-manager on skillZs</a>