Skip to main content

TdxCustomFluentDesignForm Class

The base class for Fluent Design application forms.

Declaration

TdxCustomFluentDesignForm = class(
    TdxForm,
    IdxAcrylicHostControl,
    IdxAcrylicHostControl2,
    IdxFluentDesignNavigationControlListener,
    IcxLookAndFeelNotificationListener
)

Remarks

The Fluent Design concept is created by Microsoft and released with the “Fall Creators Update” for Windows® 10. Fluent Design applications combine UI layout adaptability with complex lighting, transparency, and transition effects.

VCL Shared Libraries: A Fluent Design Form Example

Main API Members

The list below outlines key members[1] of the TdxCustomFluentDesignForm class. These members allow you to configure a Fluent Design form.

General Form Settings and Methods

The following public API members are derived from the standard TCustomForm class shipped with the VCL library:

Caption
Specifies the form’s caption.
PixelsPerInch
Specifies the base DPI value for scale factor calculations.
ShowModal
Invokes the form as a modal dialog.
Scaled
Specifies if DPI awareness is enabled for the form.
Visible | Hide | Show
Hide or display the form.
Width | Height | ClientWidth | ClientHeight
Allow you to adjust form and client area dimensions.

Tip

Refer to the TCustomForm class description for detailed information on all standard form API members.

Fluent Design UI-Specific Settings

AdaptiveLayoutOptions
Allows you to change form layout behavior in Fluent Design applications.
EnableAcrylicEffects
Specifies if acrylic effects are enabled for the form and supported controls in a Fluent Design application.
BackgroundBlur
Specifies the active form background effect when acrylic effects are enabled.
NavigationControl
Allows you to associate the form with a Navigation Bar control that supports Fluent Design effects.

Terminal TdxCustomFluentDesignForm Class Descendants

Do not use the TdxCustomFluentDesignForm class directly. Use the following descendants instead:

TdxRibbonForm
A Ribbon form class.
TdxFluentDesignForm
A Fluent Design application form.

Ribbon and Sidebar UI

If you need to use a Ribbon UI in addition to an Accordion or Hamburger Menu, use the Ribbon form instead. This form can embed both TdxRibbon and TdxNavBar controls and supports Fluent Design effects for the latter.

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.

GDI Scaled Mode Limitations

GDI Scaled is a compatibility DPI awareness mode where the operating system scales text and GDI-based primitives automatically when a window is displayed on a high-DPI monitor.

Important

We do not recommend GDI Scaled mode for application projects with DevExpress components because this mode reduces font and image quality and prevents many effects from working correctly. For example, Aero Glass and similar non-client area effects are unavailable in GDI Scaled mode.

Footnotes
  1. This list does not include internal APIs that implement DPI awareness regardless of the target Embarcadero RAD Studio® IDE version. You do not need to interact with these API members in your code in the majority of usage scenarios.

    Refer to the TdxForm class description for technical details.

See Also