RibbonControl.PageCategoryAlignment Property

Gets or sets the alignment of custom page categories, which display contextual tab pages. This is a dependency property.

Namespace: DevExpress.Xpf.Ribbon

Assembly: DevExpress.Xpf.Ribbon.v24.1.dll

NuGet Package: DevExpress.Wpf.Ribbon

Declaration

C#

public RibbonPageCategoryCaptionAlignment PageCategoryAlignment { get; set; }

VB.NET

Public Property PageCategoryAlignment As RibbonPageCategoryCaptionAlignment

Property Value

Type	Description
RibbonPageCategoryCaptionAlignment	A RibbonPageCategoryCaptionAlignment value that specifies the alignment of custom page categories.

Available values:

Name	Description
Default	The same as the RibbonPageCategoryCaptionAlignment.Left option.
Left	Headers of contextual page categories are aligned to a Ribbon Control’s left edge.
Right	Headers of contextual page categories are aligned to a Ribbon Control’s right edge.

Remarks

Custom page categories, represented by RibbonPageCategory objects, are stored in the RibbonControl’s Items collection.

If the PageCategoryAlignment property is set to Left or Default, custom page categories are displayed immediately to the right of the RibbonControl’s default pages.

If the PageCategoryAlignment property is set to Right, custom page categories are anchored to the RibbonControl’s right edge.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PageCategoryAlignment property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-create-supertips-for-bar-items-ribbon-items-and-standard-controls-in-code-and-xaml-e2702/CS/SuperTipForRibbonFromCode.xaml#L19

</Grid.RowDefinitions>
<dxr:RibbonControl x:Name="RibbonControl" ApplicationButtonLargeIcon="ribbon-application-32x32.png" ApplicationButtonText="File" PageCategoryAlignment="Right" MinimizationButtonVisibility="Visible">
    <dxr:RibbonControl.ToolbarItemLinks>

wpf-create-a-ribboncontrol/CS/RibbonControl_Ex/MainWindow.xaml#L25

ApplicationButtonText="File"
PageCategoryAlignment="Right"
RibbonStyle="Office2010"

wpf-scheduler-use-entity-framework-to-bind-to-data/CS/DXSample/MainWindow.xaml#L17

<dxr:RibbonControl DockPanel.Dock="Top"
                   PageCategoryAlignment="Right"
                   RibbonStyle="Office2019"

wpf-scheduler-disable-resource-colorization/CS/DXSample/MainWindow.xaml#L18

<dxr:RibbonControl DockPanel.Dock="Top"
                   PageCategoryAlignment="Right"
                   RibbonStyle="Office2019"