Enum HighDpiMode

Namespace

Alternet.UI

Assembly

Alternet.UI.Common.dll

Specifies the different high DPI modes.

public enum HighDpiMode

Fields

DpiUnaware = 0

Does not scale for DPI changes and always assumes a scale factor of 100%.

DpiUnawareGdiScaled = 4

Similar to DpiUnaware, but improves the quality of graphic content.

PerMonitor = 2

Checks for DPI when it's created and adjusts scale factor when the DPI changes.

PerMonitorV2 = 3

Similar to PerMonitor, but enables child window DPI change notification and improved scaling.

SystemAware = 1

Queries for the DPI of the primary monitor once and uses this for the application on all monitors.

Remarks

Specifying the high DPI mode is dependent on the OS version. Setting the high DPI mode will work on Windows 10 version 1703 or later.

Changing the DPI mode while the application is running doesn't impact scaling if you're using the `PerMonitor` value. If there is more than one monitor attached and their DPI settings are different, the DPI may change when the window is moved from one monitor to the other. In this case, the application rescales according to the new monitor's DPI settings. Alternatively, the DPI can be changed when the OS scaling setting is changed for the monitor the window is on.