RibbonForm Class

A form that supports incorporation of a RibbonControl.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

public class RibbonForm :
    XtraForm,
    ISupportGlassRegions,
    IBarObjectContainer,
    ISupportFormShadow
Public Class RibbonForm
    Inherits XtraForm
    Implements ISupportGlassRegions,
               IBarObjectContainer,
               ISupportFormShadow

Remarks

A RibbonForm is the XtraForm class descendant which supports the Microsoft Ribbon interface. The form is specifically designed to display a RibbonControl; and is not displayed properly on screen without a RibbonControl.

The RibbonForm is painted differently depending on the embedded Ribbon Control's paint style (RibbonControl.RibbonStyle). For instance, the following images show RibbonForms painted in the Office 2007 and Office 2010 styles:

Ribbon Style Image
Office 2007 RibbonForm
Office 2010 RibbonForm_Office2010

The main features of the RibbonForm:

To create a ribbon form in code, use the RibbonForm class as a base class.

using DevExpress.XtraBars;

namespace DXApplication1 {
    public partial class Form1 : RibbonForm {
        public Form1() {
            InitializeComponent();
        }
    }
}
NOTE
  • The RibbonForm doesn't support the inherited RightToLeftLayout and RightToLeft properties.

  • Do not set the RibbonForm's FormBorderStyle property to None.

  • Do not add a BarManager to a RibbonForm.

NOTE

When a DockManager is placed on a RibbonForm, you may notice slow performance during control startup rendering for complex projects. To resolve the issue, call the DockManager.ForceInitialize method on form loading.

See Ribbon Form for more information.

Inheritance

Object
MarshalByRefObject
Component
Control
ScrollableControl
ContainerControl
Form
DevExpress.XtraEditors.DForm
DevExpress.XtraEditors.MouseWheelContainerForm
See Also