TdxForm Class
The base class for DPI-aware DevExpress application forms.
Declaration
TdxForm = class(
TForm,
IdxScaleFactor
)
Remarks
The TdxForm
class is designed to substitute TForm as a form ancestor in DPI-aware applications. An instance of a form class derived from TdxForm
(TdxRibbonForm, for instance) automatically updates its scale factor and applies it to all DevExpress controls when your application accepts the WM_DPICHANGED
system message.
Main API Members
The list below outlines key members of the TdxForm
class that allow you to configure a DPI-aware application form.
- 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).
Other DPI-Aware Form Classes
DevExpress VCL products ship with the following base form classes with support for DPI-awareness:
- TdxRibbonForm
- A Ribbon form class.
- TdxFluentDesignForm
- A Fluent Design application form.
- TdxCustomForm
- The base class for DPI-aware DevExpress application forms and dialogs.
Additional Information
Refer to the following help topic for detailed information on how to adapt your application to high-DPI environments: How to: Create a Per-Monitor DPI-Aware Application.