RibbonForm.SidePane Property

Gets or sets the panel to the right of the Ribbon.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v25.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(null)]
[DXCategory("Appearance")]
public Control SidePane { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(Nothing)>
Public Property SidePane As Control

Property Value

Type	Default	Description
Control	null	The panel to the right of the Ribbon.

Remarks

The SidePane property accepts the following DevExpress controls:

• PanelControl
• AccordionControl
• NavigationPane
• WindowsUIButtonPanel
• ToolboxControl
• SidePanel

When the side panel is displayed, it shifts Ribbon content to the left.

Run Demo: Outlook-Inspired Application

Use the panel’s Visible property to display or hide the panel.

The following code snippet assigns a side panel and toggles its visibility on a bar item click:

Note

panelControl1 and barCheckItem1 were created and customized at design time.

In Code

C#

using DevExpress.XtraBars;
using DevExpress.XtraBars.Ribbon;

this.SidePane = panelControl1;
// ...
void barCheckItem1_CheckedChanged(object sender, DevExpress.XtraBars.ItemClickEventArgs e){
  this.SidePane.Visible = !this.SidePane.Visible;
}

VB.NET

Imports DevExpress.XtraBars
Imports DevExpress.XtraBars.Ribbon

Me.SidePane = panelControl1
' ...
Private Sub barCheckItem1_CheckedChanged(ByVal sender As Object, ByVal e As ItemClickEventArgs)
    Me.SidePane.Visible = Not Me.SidePane.Visible
End Sub

Notes

• The side panel control must be added directly to the form’s Controls collection.
• The Ribbon Form must be a window level control. If the Ribbon Form is a child control (for example, an MDI child form), the side panel control may exhibit unexpected behavior.