DPI_AWARENESS_CONTEXT ingang

Artikel
03/12/2025

Identificeert de bewustzijnscontext voor een venster.

Syntaxis

#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)

Constanten

DPI_AWARENESS_CONTEXT_UNAWARE

DPI niet. Dit venster wordt niet geschaald voor DPI-wijzigingen en wordt altijd uitgegaan van een schaalfactor van 100% (96 DPI). Het wordt automatisch geschaald door het systeem op een andere DPI-instelling.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

Systeem DPI-bewust. Dit venster wordt niet geschaald voor DPI-wijzigingen. Er wordt eenmaal een query uitgevoerd op de DPI en deze waarde wordt gebruikt voor de levensduur van het proces. Als de DPI wordt gewijzigd, wordt het proces niet aangepast aan de nieuwe DPI-waarde. Het wordt automatisch omhoog of omlaag geschaald door het systeem wanneer de DPI van de systeemwaarde verandert.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

Dpi-bewust per monitor. In dit venster wordt gecontroleerd op de DPI wanneer deze wordt gemaakt en wordt de schaalfactor aangepast wanneer de DPI wordt gewijzigd. Deze processen worden niet automatisch geschaald door het systeem.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

Ook wel bekend als Per Monitor v2. Een vooruitgang ten opzichte van de oorspronkelijke DPI-bewustzijnsmodus per monitor, waarmee toepassingen toegang kunnen krijgen tot nieuw DPI-gerelateerd schaalgedrag per venster op het hoogste niveau.
Per Monitor v2 is beschikbaar gesteld in de Makersupdate van Windows 10 (ook wel bekend als versie 1703) en is niet beschikbaar in eerdere versies van het besturingssysteem.
De aanvullende gedragingen die worden geïntroduceerd, zijn als volgt:

dpi-wijzigingsmeldingen voor onderliggende vensters - In per monitor v2-contexten wordt de hele vensterstructuur op de hoogte gesteld van eventuele DPI-wijzigingen die optreden.
Schalen van niet-clientgebied- Alle vensters krijgen automatisch hun niet-clientgebied getekend op een DPI-gevoelige manier. Aanroepen naar EnableNonClientDpiScaling zijn niet nodig.
Schalen van Win32-menu's - Alle NTUSER-menu's die zijn gemaakt in Per Monitor v2-contexten, worden per monitor aangepast.
dialoogvenster schalen - Win32-dialoogvensters die zijn gemaakt in per monitor v2-contexten, reageren automatisch op DPI-wijzigingen.
Verbeterde schaalaanpassing van besturingselementen voor comctl32 - Verschillende besturingselementen voor comctl32 hebben een verbeterd DPI-schaalgedrag in per monitor v2-contexten.
Verbeterd themagedrag - UxTheme-ingangen die in de context van een Per Monitor v2-venster worden geopend, werken in termen van de DPI die aan dat venster is gekoppeld.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI niet bekend met verbeterde kwaliteit van GDI-gebaseerde inhoud. Deze modus gedraagt zich op dezelfde manier als DPI_AWARENESS_CONTEXT_UNAWARE, maar stelt het systeem ook in staat om automatisch de renderingkwaliteit van tekst en andere primitieven op basis van GDI te verbeteren wanneer het venster wordt weergegeven op een high-DPI-monitor.

Zie De hoge DPI-ervaring verbeteren in desktop-apps op basis van GDIvoor meer informatie.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED werd geïntroduceerd in de update van oktober 2018 van Windows 10 (ook wel bekend als versie 1809).