TdxCustomForm Class
The base class for DPI-aware DevExpress application forms and dialogs.
Declaration
TdxCustomForm = class abstract(TCustomForm, IdxScaleFactor)
Remarks
The TdxCustomForm
class is designed to substitute TCustomForm in DPI-aware applications. An instance of a form or dialog window class derived from TdxCustomForm
automatically updates its scale factor and applies it to all DevExpress controls when your application accepts the WM_DPICHANGED
system message. For instance, TdxCustomForm
is the base class for alert and popup windows.
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).
- Apply the form scale factor to the custom-drawn UI elements (ScaleFactor).
- Respond to form DPI changes (ScaleFactorChanged and UpdateImageLists).
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.
- TdxForm
- The base class for DPI-aware DevExpress application forms.
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.