Per monitor DPI awareness

Specify Per-Monitor (V2) DPI Awareness in your project:

1. Create a new XML file in your project folder. You can copy this file from one of our examples/samples. The content of the XML file is (MyApp is your application name):

   
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <assembly
       xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3"
       manifestVersion="1.0">
       <assemblyIdentity version="5.1.0.0" type="win32" name="MyApp.exe"/>
       <description>MyApp Application</description>
   <dependency>
       <dependentAssembly>
           <assemblyIdentity
               type="win32"
               name="Microsoft.Windows.Common-Controls"
               version="6.0.0.0"
               publicKeyToken="6595b64144ccf1df"
               language="*"
               processorArchitecture="*"/>
       </dependentAssembly>
   </dependency>
   <asmv3:application>
       <asmv3:windowsSettings>
           <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
           <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">
               PerMonitorV2, PerMonitor
           </dpiAwareness>
       </asmv3:windowsSettings>
   </asmv3:application>
   </assembly>

2. Open Project Settings, switch to Manifest Tools | Input and Output and make the following changes:
   • In Additional Manifest File enter path to your XML file created in (1).
   • Set DPI Awareness to None
3. Add the following initializations in your application InitInstance source code (add them after call to CBCGPWinApp::InitInstance):

   globalData.m_bIsDlgWsCaptionStyle = TRUE;
   globalData.m_bIsMiniFrameWsCaptionStyle = TRUE;

Updating existing application source code:

1. Replace globalData.font*** with globalUtils.GetFont***(pWnd).
2. globalUtils.ScaleByDPI has a new optional parameter "current window". Please pass a pointer to the currently used window to this method.
3. CBCGPToolBar::SetSizes and CBCGPToolBar::SetMenuSizes should receive original (non-scaled) sizes.
4. If your window class has any DPI-specific resources, please reload them in WM_DPICHANGED or WM_DPICHANGED_AFTERPARENT message handler(s).
5. If you have a custom (CBCGPProp-derived) property with DPI-specific resources, please override OnDPIChanged method and reload these resources.
6. If you added icons to CBCGPOutlookBarPane, please reload them in WM_DPICHANGED message handler (see BCGPGridExample application).
7. If you are calling any CBCGPVisualManager methods in your WM_PAINT message handler, we recommend to use CBCGPPaintDC instead of CPaintDC.
8. Pass pointer to current window to CBCGPInfoBoxRenderer constructor.
9. If you have a custom, CBCGPCaptionButton-derived caption button class, please pass a pointer to the parent windows to CBCGPCaptionButton constructor.

Back to the Developer Area