Back to Devexpress

TdxCustomFluentDesignForm Class

vcl-dxcustomfluentdesignform-665b5ec7.md

latest6.4 KB
Original Source

TdxCustomFluentDesignForm Class

The base class for Fluent Design application forms.

Declaration

delphi
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.

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:

CaptionSpecifies the form’s caption.PixelsPerInchSpecifies the base DPI value for scale factor calculations.ShowModalInvokes the form as a modal dialog.ScaledSpecifies if DPI awareness is enabled for the form.Visible | Hide | ShowHide or display the form.Width | Height | ClientWidth | ClientHeightAllow 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

AdaptiveLayoutOptionsAllows you to change form layout behavior in Fluent Design applications.EnableAcrylicEffectsSpecifies if acrylic effects are enabled for the form and supported controls in a Fluent Design application.BackgroundBlurSpecifies the active form background effect when acrylic effects are enabled.NavigationControlAllows 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:

TdxRibbonFormA Ribbon form class.TdxFluentDesignFormA 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.

Implements

IcxLookAndFeelNotificationListener

Inheritance

TObject TPersistent TComponent TControl TWinControl TScrollingWinControl TCustomForm TForm TdxForm TdxCustomFluentDesignForm

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.

See Also

TdxForm Class

TdxSkinForm Class

TdxRibbonForm Class

TdxCustomFluentDesignForm Members

dxCustomFluentDesignForm Unit