Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Collapse]Navigation Controls
   [Collapse]Navigation Bar
     Views
    [Expand]Appearance
     Save and Restore Layout
    [Expand]Examples
    [Expand]Member Tables
   [Expand]Accordion Control
    Navigation Frame and Tab Pane
    Navigation Pane
    Tile Bar
   [Expand]TileNav Pane
    WindowsUI Button Panel
   [Expand]Office Navigation Bar
   [Expand]Tile Control
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Navigation Bar

The Navigation Bar (NavBarControl) is a side navigation control with expandable groups.

Expanded Add Groups

Drop a NavBarControl onto a form and use the control's smart tag to add new groups.

Each group is an instance of the NavBarGroup class. In code, groups are stored within the NavBarControl.Groups collection.

Expanded Add Items

Right-click a group and select "Add item" to populate this group.

By doing so, you create NavBarItem objects and place them into the NavBarControl.Items collection. To do the same in code, call the NavBarGroup.AddItem method.

Expanded Change Captions and Icons

To rename an item or a group, use smart tags to modify the NavElement.Caption property. Utilize the NavElement.SmallImage and NavElement.LargeImage properties to provide 16x16 and/or 32x32 pixel icons for groups and items. To switch between small and large icons, use the NavBarGroup.GroupStyle and NavBarGroup.GroupCaptionUseImage properties.

Expanded Add Separators

You can visually detach items in a group by adding separators.

Expanded Add External Controls to Groups

Change the NavBarGroup.GroupStyle property of a group to NavBarGroup.ControlContainer.

In this mode, a group can display auxiliary controls that reside inside an associated NavBarGroupControlContainer object. At design time, drag and drop controls onto the dotted container area.

The sample below illustrates how to do the same in code.

Expanded Items and Item Links

Navigation Bar groups cannot host NavBarItem objects directly. When you add items at design time, an item link for each item is automatically created and placed into the NavBarGroup.ItemLinks collection of a group. An item link is a visual representation of a NavBarItem that allows you to repeat this item across multiple groups (toolbars and Ribbons utilize the same concept).

To understand how this concept works, invoke the NavBarControl smart tag and click "Run Designer". In the designer's "Groups/Items/Links" tab, click the "Show Item List" button and drag existing items to an empty group.

You now have two copies of the same item hosted within different groups.

Note that these copies always look identical and you cannot modify the appearance of an individual link.

Expanded Clickable and Selectable Items

By default, all NavBarItem objects (and their links) act as push buttons. Handle the NavBarControl.LinkClicked and NavBarControl.LinkPressed events to perform specific actions when end-users click these items.

If you switch NavBarControl.LinkSelectionMode to a value different from "None", items will start acting as check buttons that support normal and pressed states. Depending on the exact NavBarControl.LinkSelectionMode property value, there can be one or multiple simultaneously selected item links.

To select a link in code, use the NavBarGroup.SelectedLinkIndex, NavBarGroup.SelectedLink or NavBarControl.SelectedLink properties. Changing a link state raises the NavBarControl.SelectedLinkChanged event.

Expanded Drag-And-Drop Operations

By default, end-users can drag item links to rearrange these links and/or move them from one Navigation Bar group to another. With the "Ctrl" key pressed, end-users can also copy item links to multiple locations.

This behavior is managed by the NavBarControl.DragDropFlags and NavBarGroup.DragDropFlags properties. If these properties allow the NavBarDragDrop.AllowOuterDrop flag, end-users will be able to move/copy item links from one Navigation Bar to another.

How would you rate this topic?​​​​​​​