DPI_AWARENESS_CONTEXT handtag

Artikel
03/12/2025

Identifierar medvetenhetskontexten för ett fönster.

Syntax

#define DPI_AWARENESS_CONTEXT_UNAWARE              ((DPI_AWARENESS_CONTEXT)-1)
#define DPI_AWARENESS_CONTEXT_SYSTEM_AWARE         ((DPI_AWARENESS_CONTEXT)-2)
#define DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE    ((DPI_AWARENESS_CONTEXT)-3)
#define DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 ((DPI_AWARENESS_CONTEXT)-4)
#define DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED    ((DPI_AWARENESS_CONTEXT)-5)

Konstanter

DPI_AWARENESS_CONTEXT_UNAWARE

DPI omedveten. Det här fönstret skalas inte för DPI-ändringar och antas alltid ha en skalningsfaktor på 100% (96 DPI). Den skalas automatiskt av systemet på andra DPI-inställningar.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

System-DPI-medveten. Det här fönstret skalas inte för DPI-ändringar. Den frågar efter DPI en gång och använder det värdet under processens livslängd. Om DPI:n ändras justeras inte processen till det nya DPI-värdet. Den skalas automatiskt upp eller ned av systemet när DPI:et ändras från systemvärdet.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

DPI-information per övervakare. Det här fönstret söker efter DPI när den skapas och justerar skalningsfaktorn när DPI:et ändras. Dessa processer skalas inte automatiskt av systemet.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

Kallas även Per Monitor v2. Ett framsteg jämfört med det ursprungliga DPI-medvetenhetsläget per övervakare, som gör det möjligt för program att komma åt nya DPI-relaterade skalningsbeteenden per toppnivå.
Per Monitor v2 gjordes tillgänglig i Creators Update of Windows 10 (kallas även version 1703) och är inte tillgänglig i tidigare versioner av operativsystemet.
De ytterligare beteenden som introduceras är följande:

underordnad fönster DPI ändrar meddelanden – I kontexter per övervakare v2 meddelas hela fönsterträdet om eventuella DPI-ändringar som inträffar.
skalning av icke-klientområde – Alla fönster får automatiskt sitt icke-klientområde ritat på ett DPI-känsligt sätt. Anrop till EnableNonClientDpiScaling är onödiga.
skalning av Win32-menyer – Alla NTUSER-menyer som skapats i Kontexter per övervakare v2 skalas per bildskärm.
Dialog Scaling – Win32-dialogrutor som skapats i Kontexter per övervakare v2 svarar automatiskt på DPI-ändringar.
Förbättrad skalning av comctl32-kontroller – Olika comctl32-kontroller har förbättrat DPI-skalningsbeteendet i Kontexter för per övervakare v2.
Förbättrat temabeteende – UxTheme-referenser som öppnas i kontexten för ett Per Monitor v2-fönster fungerar när det gäller den DPI som är associerad med det fönstret.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI omedveten om förbättrad kvalitet på GDI-baserat innehåll. Det här läget fungerar på samma sätt som DPI_AWARENESS_CONTEXT_UNAWARE, men gör det också möjligt för systemet att automatiskt förbättra återgivningskvaliteten för text och andra GDI-baserade primitiver när fönstret visas på en hög DPI-övervakare.

Mer information finns i Förbättra funktionen för hög DPI i GDI-baserade skrivbordsappar.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED introducerades i oktober 2018-uppdateringen av Windows 10 (även kallad version 1809).