Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Collapse]Ribbon, Bars and Menu
   [Expand]Common Features
   [Expand]Bars
   [Collapse]Ribbon
    [Expand]Overview
    [Collapse]Ribbon Structure
      Ribbon Control
      Ribbon Page Categories and Contextual Pages
      Ribbon Page
      Ribbon Page Group
      Ribbon Quick Access Toolbar
      Ribbon Status Bar
      DXRibbonWindow
    [Expand]Populating Ribbon
    [Expand]Ribbon Menu
    [Expand]Features
     Runtime Customization
    [Expand]Examples
   [Expand]Menus
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[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

Ribbon Page

The Ribbon Control consists of page categories, which own ribbon pages. The pages are represented as tabs, and they are structurally and visually split into groups that display various commands, static items, editors and galleries. The following image shows a RibbonControl containing two pages (Home and Gallery Page). The Home page, which is active, consists of two groups (File and Edit):

Each Ribbon page in the RibbonControl belongs to either the default or custom page category. Pages that belong to the default page category are displayed at the left edge of the RibbonControl. Typically, these pages are designed to be always visible during application runtime. If you need to create contextual pages (pages that provide context specific commands), use custom page categories. To learn more, see Ribbon Page Categories and Contextual Pages.

Expanded Ribbon Page Settings

Ribbon pages are represented by the RibbonPage class objects. For each page, specify a caption (RibbonPage.Caption) that will be displayed in the corresponding tab.

To add groups to a Ribbon page, add RibbonPageGroup objects to the RibbonPage.Groups collection. In XAML, you can define RibbonPageGroup objects directly between the RibbonPage start and end tags.

You can access a category that owns a page via the RibbonPage.PageCategory property. The category's RibbonPageCategoryBase.IsDefault property indicates whether the category is default or custom.

Expanded Navigating Pages and Controlling Page Visibility

The currently active page is specified by the RibbonControl.SelectedPage property. Assigning a page to this property allows you to activate this page. You can also activate a page via the RibbonPage.IsSelected property.

It's possible to hide a particular page via its RibbonPage.IsVisible property. If a page belongs to a custom category, you can hide all pages in this category by setting the RibbonPageCategoryBase.IsVisible property to false.

Expanded Examples

Is this topic helpful?​​​​​​​