RibbonControl.SelectedPageOnMerging Property

Gets or sets which RibbonControl‘s selected page will be selected after ribbon controls are merged.

Namespace: DevExpress.Xpf.Ribbon

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

NuGet Package: DevExpress.Wpf.Ribbon

Declaration

C#

public SelectedPageOnMerging SelectedPageOnMerging { get; set; }

VB.NET

Public Property SelectedPageOnMerging As SelectedPageOnMerging

Property Value

Type	Description
SelectedPageOnMerging	A SelectedPageOnMerging enumerator value indicating which RibbonControl‘s selected page will be selected after ribbon controls are merged.

Available values:

Name	Description
ParentSelectedPage	Specifies that the parent RibbonControl‘s currently selected page should be selected within a resulting RibbonControl.
SelectedPage	Specifies that the child RibbonControl‘s currently selected page should be selected within a resulting RibbonControl.

Remarks

RibbonControls within a parent and a child panels can initially have RibbonPages with different captions selected. In this case, merging these ribbons results in a situation where it is uncertain as to which page should be selected within the merged RibbonControl. To specify it manually, use the child Ribbon Control’s SelectedPageOnMerging property. Depending on the SelectedPageOnMerging property value, the resulting RibbonControl can select either a parent Ribbon Control’s selected page, or the child’s page.

Note

The SelectedPageOnMerging property makes sense only when applied to the child RibbonControl and has no effect on the parent RibbonControl.

See the MDI Ribbon Merging topic to learn more.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SelectedPageOnMerging 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

wpf-docklayoutmanager-merge-ribbon-controls/CS/WpfApplication1/MainWindow.xaml#L8

<DockPanel>
    <dxr:RibbonControl x:Name="ParentRibbonControl" DockPanel.Dock="Top" Height="auto" MDIMergeStyle="Always" SelectedPageOnMerging="ParentSelectedPage">
        <dxr:RibbonDefaultPageCategory>