HighDpiMode Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Specifies the different high DPI modes that can be applied to an application.
public enum class HighDpiModepublic enum HighDpiModetype HighDpiMode = Public Enum HighDpiMode- Inheritance
Fields
| Name | Value | Description |
|---|---|---|
| DpiUnaware | 0 | The application window does not scale for DPI changes and always assumes a scale factor of 100%. |
| SystemAware | 1 | The window queries for the DPI of the primary monitor once and uses this for the application on all monitors. |
| PerMonitor | 2 | The window 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, improved scaling of comctl32 controls, and dialog scaling. |
| DpiUnawareGdiScaled | 4 | Similar to DpiUnaware, but improves the quality of GDI/GDI+ based content. |
Remarks
Specifying the high DPI mode is dependent on the OS version of the machine you're running your application on. Setting the high DPI mode will work on machines running Windows 10 Creators Update (version 1703) or later versions.
Changing the DPI mode after the application has started running doesn't impact scaling (that is, the change won't take effect).
If you're using the PerMonitor value and there is more than one monitor attached with different DPI settings, 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 of a window can be changed when the OS scaling setting is changed for the monitor the window is on.
