RibbonControl Class

In This Article

Declaration

Represents the Ribbon Control.

Namespace: DevExpress.Xpf.Ribbon

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

#Declaration

C#
VB.NET

[ToolboxTabName("DX.14.2: Navigation & Layout")]
[DXToolboxBrowsable]
public class RibbonControl :
    Control,
    IRibbonControl,
    IBarsSerializableOwner,
    ISupportInitialize,
    ILogicalChildrenContainer,
    IMergingSupport,
    IMultipleElementRegistratorSupport,
    IBarNameScopeSupport,
    IInputElement,
    IHierarchicalMergingSupport<RibbonControl>

<ToolboxTabName("DX.14.2: Navigation & Layout")>
<DXToolboxBrowsable>
Public Class RibbonControl
    Inherits Control
    Implements IRibbonControl,
               IBarsSerializableOwner,
               ISupportInitialize,
               ILogicalChildrenContainer,
               IMergingSupport,
               IMultipleElementRegistratorSupport,
               IBarNameScopeSupport,
               IInputElement,
               IHierarchicalMergingSupport(Of RibbonControl)

#Returned By

Properties and methods that return RibbonControl instances:

Show 11 links

#Remarks

The RibbonControl represents a visual control which can display various items (buttons, in-place editors, sub-menus, galleries, etc), by categorizing them into pages and page groups.

DXRibbon

NOTE

Commands, submenus, static text, editors and other in-ribbon elements are represented by corresponding bar item objects. For these objects to be displayed within a RibbonControl and RibbonStatusBarControl, they first must be created within a BarManager object, which represents a storage of bar items. The RibbonControl and RibbonStatusBarControl must be children of this BarManager, i.e. must be declared in XAML between the start and end BarManager tags.

Structurally, a RibbonControl consists of page categories, which contain ribbon pages. There is always one default page category (RibbonDefaultPageCategory). Plus, you can create any number of custom page categories (RibbonPageCategory) to implement contextual pages (pages that are made temporarily visible on specific events). In the image above, the RibbonControl contains only the default page category.The following image shows a RibbonControl with a custom Image Tools category containing a Format page:

RibbonControl_CustomCategorySelection