Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

RibbonForm Class

A form that supports incorporation of a RibbonControl.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

public class RibbonForm :
    XtraForm,
    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.

Important

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

Show 14 items
See Also