TdxCustomRibbonForm Class

The base class for Ribbon-based application forms.

Declaration

TdxCustomRibbonForm = class(
    TdxCustomFluentDesignForm,
    IcxDialogMetricsClientSize,
    IdxRibbonFormControllerHelper,
    IdxRibbonFormPaintData
)

Remarks

This form is designed as the main window in complex Ribbon UI-based applications, with optional support for Fluent Design effects on Microsoft Windows® 10. The TdxCustomRibbonClass implements the functionality required to integrate a TdxRibbon control as the main application UI, including additional caption bar buttons.

Ribbon Form Example

The DevExpress VCL 22.1 Ribbon Based Application template creates a new application project with a form derived from the TdxRibbonForm class. The new form has a preconfigured TdxSkinController component and an embedded TdxRibbon control with a single tab. Click the File → New → Other… item in the IDE’s main menu to invoke the “New Items” dialog, and select the Ribbon-based application template.

Ribbon Form Template

Select a Ribbon style.

Ribbon Styles

The TdxCustomRibbonForm class has members that allow you to do the following:

Associate the form with Ribbon and navigation controls (RibbonControl and NavigationControl).
Use a skin-based color scheme (UseSkinColor).
Extend skin effects to the form’s non-client area (DisableAero).
Enable or disable acrylic effects for supported controls in a Fluent Design application (EnableAcrylicEffects).
Switch between available background effects (BackgroundBlur).
Customize the base window functionality (BorderIcons and BorderStyle).
Enable or disable a shadow for the form (ShowFormShadow).
Switch between available form corner shapes (FormCorners).
Shift the form’s layout to a non-client area at runtime AdjustLayoutForNonClientDrawing.
Adjust the height of the form’s title bar GetCaptionHeightDelta).
Recalculate and redraw the form’s content (FullUpdate).