Skip to main content

RibbonPage Class

Represents a Ribbon Page within a RibbonControl.

Namespace: DevExpress.Xpf.Ribbon

Assembly: DevExpress.Xpf.Ribbon.v14.2.dll

#Declaration

public class RibbonPage :
    FrameworkContentElement,
    ICloneable,
    IRibbonCustomizationSupport,
    IBarsSerializableOwner,
    IBarsSerializable,
    IMultipleElementRegistratorSupport,
    IBarNameScopeSupport,
    IInputElement

#Remarks

This class represents a Ribbon Page within a RibbonControl.

Ribbon pages can belong to either the default page category or to a custom page category. Pages that belong to the default page category are regular pages, and they should be designed to contain commands that are always visible during the application run. Pages that belong to custom page categories are intended to display context-dependant commands.

To add pages to a page category (default or custom), first, create a category object and then add the pages to this category's Pages collection. The default and custom page category are represented by the RibbonDefaultPageCategory and RibbonPageCategory classes, respectively.

Ribbon pages are containers for RibbonPageGroup objects. Use the RibbonPage.Groups property to specify the page groups to display in the page.

To select (activate) a specific page, use RibbonPage.IsSelected or RibbonControl.SelectedPage.

#Examples

This example shows how to create a Default Page Category containing one "Home" page. The "Home" page contains three page groups ("File", "Edit" and "Format"), each displaying specific commands.

The following image shows the result:

RibbonControl_Ex

See Also