Skip to main content Início Criadores syncfusion winforms-ui-components-skills syncfusion-winforms-navigation-pane
syncfusion-winforms-navigation-pane Guide for implementing Syncfusion GroupBar (Navigation Pane) control in Windows Forms applications. Use when creating Outlook-style navigation, hierarchical sidebar navigation, collapsible group containers, or toolbox-style interfaces. Covers stacked navigation panes, Office 2007/2010/2016 themed navigation, nested GroupBar containers, and categorized control collections for structured navigation layouts.
Ir para a instalação Skills Marketplace Descubra e explore skills de IA criadas pela comunidade.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Mostrar detalhes do prompt Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-navigation-paneO comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.
Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.
Baixar Zip Baixando... Ocupações relacionadas SOC
Baseado na classificação ocupacional SOC
Explorador de arquivos
8 arquivos name syncfusion-winforms-navigation-pane description Guide for implementing Syncfusion GroupBar (Navigation Pane) control in Windows Forms applications. Use when creating Outlook-style navigation, hierarchical sidebar navigation, collapsible group containers, or toolbox-style interfaces. Covers stacked navigation panes, Office 2007/2010/2016 themed navigation, nested GroupBar containers, and categorized control collections for structured navigation layouts. metadata {"author":"Syncfusion Inc","version":"34.1.29"}
Implementing Navigation Panes (GroupBar) in Syncfusion WinForms
This skill guides you in implementing Syncfusion.Tools.WinForms (Navigation Pane) control—an Outlook-style navigation container that displays hierarchical groups with collapsible sections and child item collections.
When to Use This Skill
Use this skill when the user needs to:
Implement Outlook-style navigation panes (similar to Microsoft Outlook sidebar)
Create hierarchical sidebar navigation with collapsible groups
Build toolbox-style interfaces (like Visual Studio .NET toolbox)
Add categorized control collections with GroupBarItems
Implement GroupView for displaying child items within groups
Enable StackedMode for navigation pane at bottom (Outlook-style)
Apply Office 2007/2010/2016 themes and Metro styles
Create nested GroupBar (GroupBar within GroupBar)
Add in-place renaming of navigation items
Implement serialization to save/restore navigation layout
Customize headers, borders, colors, and animations
Replace standard panels with themed navigation containers GroupBar is ideal for applications requiring categorized navigation, toolbox-style interfaces, or Outlook-inspired sidebar layouts.
Component Overview GroupBar (Navigation Pane) is a container control that displays multiple groups (GroupBarItems) where only one selected group's content is visible at a time. It works with GroupView to display child items. Key capabilities:
GroupBarItem : Tab-like navigation items (groups/categories)GroupView : Client control for displaying child items within groupsGroupViewItem : Individual child items within a GroupViewStackedMode : Navigation pane mode (like Outlook) with collapsible stackOffice Themes : Office 2007/2010/2016, Metro, Office2016Colorful/White/DarkGray/BlackNested GroupBar : Host GroupBar within another GroupBarSerialization : Save/restore layout state and item positionsCustomizable Appearance : Headers, borders, colors, fonts, animationsIn-Place Renaming : Edit GroupBarItem names at runtimeLocalization : Multi-language support Key Difference from Standard Panel/TabControl:
GroupBar provides Outlook-style navigation with GroupView integration, StackedMode for collapsible navigation pane, Office themes, and hierarchical item display capabilities.
Additional Resources Assembly: Syncfusion.Shared.Base.dllNamespace: Syncfusion.Windows.Forms.ToolsNuGet Package: Syncfusion.Shared.Base
Minimum .NET Framework: 4.5
Documentation and Navigation Guide
Getting Started and Basic Setup Read this reference when users need:
Assembly dependencies and NuGet package installation
Namespace: Syncfusion.Windows.Forms.Tools
Creating GroupBar via designer or code
Adding GroupBarItems to the control
Basic GroupBar configuration
Understanding GroupBar structure
Complete minimal working example
GroupBar Items and Structure Read this reference when users need:
Creating GroupBarItem instances
Text property for item labels
Image property for item icons
Client property (linking to GroupView)
GroupBarItems collection management
Item selection and navigation
GroupBarItemSelected event handling
Complete group navigation examples
GroupView and Child Items Read this reference when users need:
GroupView overview (client control for groups)
Creating GroupView instances
GroupViewItem for child items
Adding items to GroupViewItems collection
Linking GroupView to GroupBarItem.Client
Item selection in GroupView
GroupViewItem click events
Building toolbox-style interfaces
Stacked Mode (Navigation Pane) Read this reference when users need:
StackedMode property (Outlook-style navigation)
Navigation pane at bottom
HeaderHeight property for collapsed state
Navigation between stacked items
Expanded/collapsed state management
Serialization of stacked layout
Complete Outlook clone example
Visual Styles and Themes Read this reference when users need:
VisualStyle property overview
Office2007 theme (Blue, Silver, Black, Managed)
Office2007Outlook theme
Office2010 theme (Blue, Silver, Black, Managed)
Metro theme
Office2016 themes (Colorful, White, DarkGray, Black)
Managed colors for custom branding
Theme comparison and selection
Applying themes at runtime
Appearance Customization Read this reference when users need:
Header customization (colors, fonts, height)
Border settings (styles, colors)
Text alignment and settings
Image display configuration
Tooltip settings
Cursor customization
Animation settings
Custom colors and gradients
Advanced Features and Configuration Read this reference when users need:
Nested GroupBar support (GroupBar in GroupBar)
In-place renaming of GroupBarItems
Serialization of layout state
Localization support
Link selection in GroupView
Custom control hosting
Event handling (GroupBarItemSelected, etc.)
Complex navigation scenarios
Quick Start Example Here's a minimal example creating a GroupBar with items and child content:
using Syncfusion.Windows.Forms.Tools;
using System;
using System.Drawing;
using System.Windows.Forms;
public class GroupBarExample : Form
{
private GroupBar groupBar1;
public GroupBarExample ()new GroupBar();
groupBar1.Dock = DockStyle.Left;
groupBar1.Width = 200 ;
GroupBarItem mailItem = new GroupBarItem();
mailItem.Text = "Mail" ;
GroupBarItem calendarItem = new GroupBarItem();
calendarItem.Text = "Calendar" ;
GroupBarItem contactsItem = new GroupBarItem();
contactsItem.Text = "Contacts" ;
groupBar1.GroupBarItems.AddRange(new GroupBarItem[] {
mailItem,
calendarItem,
contactsItem
});
this .Controls.Add(groupBar1);
this .Text = "GroupBar Example" ;
this .Size = new Size(600 , 400 );
}
}
Result: A left-docked navigation pane with 3 groups (Mail, Calendar, Contacts) similar to Microsoft Outlook.
Common Patterns
Outlook-Style Navigation with GroupView Pattern: Create an Outlook-inspired navigation pane with child items.
GroupBar groupBar = new GroupBar();
groupBar.Dock = DockStyle.Left;
groupBar.Width = 220 ;
groupBar.VisualStyle = VisualStyle.Office2016Colorful;
GroupBarItem mailItem = new GroupBarItem();
mailItem.Text = "Mail Folders" ;
GroupView mailView = new GroupView();
mailView.Name = "MailView" ;
mailView.GroupViewItems.AddRange(new GroupViewItem[] {
new GroupViewItem("Inbox" , 0 , true , null , "Inbox" ),
new GroupViewItem("Drafts" , 1 , true , null , "Drafts" ),
new GroupViewItem("Sent Items" , 2 , true , null , "Sent" ),
new GroupViewItem("Deleted Items" , 3 , true , null , "Deleted" )
});
mailItem.Client = mailView;
groupBar.Controls.Add(mailView);
groupBar.GroupBarItems.Add(mailItem);
mailView.GroupViewItemSelected += (s, e) => {
string folderName = ((sender as GroupView)?.SelectedItem >= 0 ? (sender as GroupView).GroupViewItems[(sender as GroupView).SelectedItem].Text : null )`;
LoadMailFolder(folderName);
};
this .Controls.Add(groupBar);
When: User needs Outlook-style mail navigation with folder hierarchy.
Visual Studio Toolbox Clone Pattern: Create a toolbox-style interface with categorized controls.
GroupBar toolbox = new GroupBar();
toolbox.Dock = DockStyle.Left;
toolbox.Width = 200 ;
toolbox.VisualStyle = VisualStyle.Office2010;
GroupBarItem winFormsItem = new GroupBarItem();
winFormsItem.Text = "Windows Forms" ;
GroupView winFormsView = new GroupView();
winFormsView.GroupViewItems.AddRange(new GroupViewItem[] {
new GroupViewItem("Button" , 0 , true , null , "Button" ),
new GroupViewItem("TextBox" , 1 , true , null , "TextBox" ),
new GroupViewItem("Label" , 2 , true , null , "Label" ),
new GroupViewItem("ComboBox" , 3 , true , null , "ComboBox" )
});
GroupBarItem dataItem = new GroupBarItem();
dataItem.Text = "Data" ;
GroupView dataView = new GroupView();
dataView.GroupViewItems.AddRange(new GroupViewItem[] {
new GroupViewItem("DataSet" , 0 , true , null , "DataSet" ),
new GroupViewItem("DataTable" , 1 , true , null , "DataTable" ),
new GroupViewItem("BindingSource" , 2 , true , null , "BindingSource" )
});
winFormsItem.Client = winFormsView;
dataItem.Client = dataView;
toolbox.Controls.Add(winFormsView);
toolbox.Controls.Add(dataView);
toolbox.GroupBarItems.Add(winFormsItem);
toolbox.GroupBarItems.Add(dataItem);
this .Controls.Add(toolbox);
When: User needs a categorized toolbox with collapsible sections like Visual Studio.
Stacked Navigation Pane (Outlook Mode) Pattern: Enable Outlook-style stacked navigation with bottom pane.
GroupBar navPane = new GroupBar();
navPane.Dock = DockStyle.Left;
navPane.Width = 220 ;
navPane.StackedMode = true ;
navPane.VisualStyle = VisualStyle.Office2016White;
GroupBarItem mailItem = new GroupBarItem();
mailItem.Text = "Mail" ;
GroupBarItem calendarItem = new GroupBarItem();
calendarItem.Text = "Calendar" ;
GroupBarItem contactsItem = new GroupBarItem();
contactsItem.Text = "Contacts" ;
GroupBarItem tasksItem = new GroupBarItem();
tasksItem.Text = "Tasks" ;
navPane.GroupBarItems.AddRange(new GroupBarItem[] {
mailItem,
calendarItem,
contactsItem,
tasksItem
});
navPane.GroupBarItemSelected += (s, e) => {
string selectedSection = ((sender as GroupView)?.SelectedItem >= 0 ? (sender as GroupView).GroupViewItems[(sender as GroupView).SelectedItem].Text : null )`;
LoadSection(selectedSection);
};
this .Controls.Add(navPane);
When: User needs Outlook-style navigation with stacked items and bottom navigation pane.
Key Properties
Core Properties Property Type Description When to Use GroupBarItemsCollection Collection of GroupBarItem instances Add navigation groups SelectedItemGroupBarItem Currently selected item Get/set active group StackedModebool Enable Outlook-style stacked navigation Outlook-like layout VisualStyleVisualStyle Visual theme Apply Office themes HeaderHeightint Height of GroupBar header Customize header size
GroupBarItem Properties Property Type Description When to Use Textstring Item display text Set group label ImageImage Item icon image Add visual identifier ClientControl Client control (typically GroupView) Link content to item Selectedbool Whether item is selected Check/set selection
GroupView Properties Property Type Description When to Use GroupViewItemsCollection Child items in the view Add child items SelectedItemGroupViewItem Currently selected child Get/set selected child Namestring Identifier for the view Reference the view
Styling Properties Property Type Description When to Use VisualStyleVisualStyle Theme (Office2007/2010/2016/Metro) Apply themes Office2007ThemeOffice2007Theme Office2007 color scheme Blue/Silver/Black/Managed Office2010ThemeOffice2010Theme Office2010 color scheme Blue/Silver/Black/Managed BorderStyleBorderStyle Border appearance Customize borders BackColorColor Background color Custom backgrounds
Advanced Properties Property Type Description When to Use AllowCollapsebool Allow collapsing groups Enable collapse behavior AllowInPlaceEditingbool Enable item renaming Runtime editing AnimateCollapsebool Animate collapse/expand Smooth transitions ShowToolTipsbool Display tooltips Show item descriptions
Common Use Cases
Email Client Navigation Outlook-style navigation with mail folders:
Mail folders (Inbox, Drafts, Sent, Deleted)
Calendar view with appointments
Contacts list with categories
Tasks with priority sections
IDE Toolbox Interfaces Visual Studio-style toolboxes:
Categorized control collections
Component categories (Data, Layout, Controls)
Collapsible sections
Drag-drop tool selection
Document Management Systems Hierarchical document navigation:
Document categories and folders
Project hierarchies
File type groupings
Archive sections
Settings and Configuration Panels Categorized settings navigation:
General settings section
Account preferences
Advanced options
Theme customization
Implementation Checklist When implementing GroupBar (Navigation Pane), ensure:
✅ Required assemblies referenced (Syncfusion.Shared.Base.dll)
✅ Namespace included (Syncfusion.Windows.Forms.Tools)
✅ GroupBar instance created and configured
✅ GroupBarItems added to GroupBarItems collection
✅ GroupView created if displaying child items
✅ Client property set to link GroupView to GroupBarItem
✅ Visual style applied (VisualStyle property)
✅ Dock property set for proper layout (typically DockStyle.Left)
✅ Event handlers added for item selection
✅ Testing with multiple items and navigation
Troubleshooting Quick Reference Issue: GroupBar not visible
Check if GroupBar is added to form's Controls
Set Dock property (DockStyle.Left recommended)
Verify Width property is sufficient (200-250 pixels typical)
Ensure form has space for docked control
Issue: GroupBarItems not appearing
Verify items are added to GroupBarItems collection
Check Text property is set on each item
Ensure GroupBar.Visible = true
Verify items are not collapsed/hidden
Issue: Child items (GroupViewItems) not displaying
Create GroupView instance
Add GroupViewItems to GroupView.GroupViewItems collection
Set GroupBarItem.Client = groupView
Add GroupView to GroupBar.Controls collection
Issue: StackedMode not working
Set StackedMode = true
Ensure multiple GroupBarItems exist (need 2+ for stacking)
Check HeaderHeight property (0 hides header)
Verify visual style supports stacked mode
Issue: Theme not applying
Set VisualStyle property to desired theme
For Office2007/2010, set corresponding theme property (Office2007Theme, Office2010Theme)
For managed colors, call ApplyManagedColors method
Ensure Syncfusion.Shared.Base assembly is referenced
Issue: GroupView selection not working
Handle GroupViewItemSelected event
Check GroupView.SelectedItem property
Ensure GroupViewItems have unique identifiers
Verify click events are wired up
Summary GroupBar (Navigation Pane) provides Outlook-style navigation functionality with:
Hierarchical Navigation : GroupBarItem groups with GroupView child itemsStacked Mode : Outlook-style navigation pane with collapsible sectionsOffice Themes : Office 2007/2010/2016, Metro, and custom themesNested Support : GroupBar within GroupBar capabilitySerialization : Save/restore layout stateCustomizable Appearance : Headers, borders, colors, animations Use GroupBar when Outlook-style navigation, toolbox interfaces, categorized hierarchies, or themed navigation containers are needed for creating professional and organized WinForms applications.
