TdxRibbonForm Class
A Ribbon form class.
Declaration
TdxRibbonForm = class(
TdxCustomRibbonForm
)
Remarks
The TdxRibbonForm
class implements Ribbon form functionality with support for Fluent Design effects on Microsoft Windows® 10 and newer operating systems. A Ribbon form can integrate a TdxRibbon control with its title bar as the main application UI and display additional title bar buttons.
Fluent Design Application Template
The DevExpress VCL 23.2 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 one tab.
To create a new Fluent Design application, click File | New → Other… in the main menu of your RAD Studio IDE. Then, select the DevExpress VCL 23.2 Fluent Design Application template.
Select a Ribbon style.
Main API Members
The list below outlines key members of the TdxRibbonForm
class that allow you to configure a Ribbon form.
- Associate the form with Ribbon and navigation controls (RibbonControl and NavigationControl).
- Use a skin-based color scheme (UseSkinColor).
- Extend skin effects to the non-client form area (DisableAero).
- Enable or disable acrylic effects for supported controls in a Fluent Design application (EnableAcrylicEffects).
- Switch between available background effects (BackgroundBlur).
- Customize base window functionality (BorderIcons and BorderStyle).
- Enable or disable the form shadow (ShowFormShadow).
- Switch between available form corner shapes (FormCorners).
- Shift the form layout to a non-client area at runtime (AdjustLayoutForNonClientDrawing).
- Adjust title bar height (GetCaptionHeightDelta).
- Recalculate and redraw form content (FullUpdate).
- Change how an application UI responds to form resize operations (AdaptiveLayoutOptions).
- Hide or display the form (Visible, Hide, and Show).
- Display the form as a modal dialog (ShowModal).
- Disable or enable DPI awareness (Scaled).
- Specify form dimensions (Width and Height).
- Change the form’s caption (Caption).
- Adjust client height and width (ClientHeight and ClientWidth).
- Specify the base DPI value for scale factor calculations (PixelsPerInch).
- Scale the form and its components (ScaleForPPI, ScaleBy, and ChangeScale).
- Apply the form scale factor to custom UI elements (ScaleFactor).
- Respond to form DPI changes (ScaleFactorChanged).
Limitations
- Fluent Design effects are available only if an application runs under Microsoft Windows® 10 Version 1803 (build 17064) or a newer operating system.
- Only the TdxNavBar control supports background acrylic effects.
- Place all other controls on a TdxLayoutControl to avoid possible rendering issues related to Fluent Design effects.
- Aero Glass and similar non-client area effects are disabled if an application is in GDI Scaled mode.