Log In
[Expand]General Information
[Collapse]WinForms Controls
 [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]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Collapse]Navigation Controls
   [Expand]Navigation Bar
   [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]PDF Viewer
  [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]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Navigation Pane

NavigationPane is an advanced navigation control that hosts NavigationPage objects. Visually, the navigation pane is divided into two areas - page header area and page content area.

The Page header area displays vertically aligned page headers, which act as tabs. Each tab can display a page image (the Image property) and\or page caption (the PageText or, if not set, the Caption properties). The ShowMode property, accessed through the Properties group, specifies which of these elements should be shown.

Clicking any page header expands the page content area - a resizeable pane that displays the contents of this page (controls, added to the page's Controls collection). This area has its own header that contains the page caption (the Caption property), the page's custom header buttons (the NavigationPage.CustomHeaderButtons collection), page expand\collapse button and pane expand\collapse button. The page content area is sized according to the NavigationPane.RegularSize property value and if the NavigationPane.AllowResize property is not set to false, can be resized at runtime.

The following animation illustrates main features of the Navigation Pane.

Page headers along with their content can be aligned either vertically or horizontally depending on the NavigationPane.ItemOrientation property value (see the figure below).

At design time, you can use the Navigation Pane smart-tag to add new NavigationPages. As well as the NavigationFrame control that also hosts navigation pages, the Navigation Pane control displays navigation elements at design-time that help you to quickly toggle through existing pages (see the figure below). These navigation elements are not shown at runtime.

When a user selects a page, the NavigationFrame.SelectedPageChanging raises. Handle this event to perform additional actions.

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