[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Collapse]Ribbon, Bars and Menu
   [Expand]Common Features
    [Collapse]Ribbon Structure
      Ribbon Control
      Ribbon Page Categories and Contextual Pages
      Ribbon Page
      Ribbon Page Group
      Ribbon Quick Access Toolbar
      Ribbon Status Bar
      Ribbon Control Integration
    [Expand]Populating Ribbon
    [Expand]Ribbon Menu
     Runtime Customization
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Ribbon Page Group

Expanded Ribbon Page Group

A Ribbon Page Group is a group of bar items (regular and check buttons, submenus, editors, etc.) within a Ribbon Page. Groups are used to combine commands that have certain features in common.

A Ribbon Page Group is represented by the RibbonPageGroup component. To add page groups to a page, add RibbonPageGroup objects to the RibbonPage.Groups collection. In XAML, you can define groups directly between the RibbonPage start and end tags.

A Ribbon page group's children are bar items and/or bar item links. To add elements to a group, use the RibbonPageGroup.Items collection. In XAML you can define child elements directly between the RibbonPageGroup start and end tags.

For each bar item, you can assign large and small icons. Large icons are used by default if there is enough space within a group. However, when the group's region becomes smaller, large icons are automatically replaced with small icons, and text is hidden if necessary. If the group's size is reduced so it can no longer display all of its items at one time, the group is collapsed. To prevent a page group from being collapsed, set its RibbonPageGroup.AllowCollapse property to false.

Clicking a collapsed group's Dropdown button invokes the popup which contains the group's contents:

Expanded Bar Item Arrangement Rules

There are several bar item arrangement principles used by the RibbonControl. You will want to familiarize yourself with these principles, to better arrange bar items in your application:

  • For each bar item, which represents a button or sub-menu, you can assign both large and small images. By default, such an item can be displayed using the large image with text, small image with text and small image without text. The BarItem.RibbonStyle property allows you to control which of these options are available.
  • If both large and small images are assigned to a bar item, the large image is used by default (if there is enough space to display it). Small images are used when the group's region is too small to display large images.
  • If a bar item is represented by a large image, no other item can be displayed above or below it.
  • Only one, two or three bar items with small images can be arranged vertically within a group.

Expanded Examples

Expanded See Also

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