handle DPI_AWARENESS_CONTEXT

Articolo
11/01/2024

Identifica il contesto di consapevolezza per una finestra.

Sintassi

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

Costanti

DPI_AWARENESS_CONTEXT_UNAWARE

DPI non a conoscenza. Questa finestra non viene ridimensionata per le modifiche dpi e si presuppone che abbia sempre un fattore di scala pari al 100% (96 DPI). Verrà ridimensionato automaticamente dal sistema in qualsiasi altra impostazione DPI.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

Riconoscimento DPI del sistema. Questa finestra non viene ridimensionata per le modifiche dpi. Eseguirà una query per il valore DPI una volta e userà tale valore per la durata del processo. Se il valore DPI cambia, il processo non verrà modificato in base al nuovo valore DPI. Verrà automaticamente ridimensionato verso l'alto o verso il basso dal sistema quando il valore DPI cambia rispetto al valore di sistema.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

Per monitor DPI con riconoscimento. Questa finestra controlla la presenza di valori DPI al momento della creazione e regola il fattore di scala ogni volta che cambia il valore DPI. Questi processi non vengono ridimensionati automaticamente dal sistema.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

Noto anche come Per Monitor v2. Un progresso rispetto alla modalità originale di riconoscimento DPI per monitor, che consente alle applicazioni di accedere ai nuovi comportamenti di ridimensionamento correlati a DPI in base a una finestra di primo livello.
Per Monitor v2 è stato reso disponibile in Creators Update di Windows 10 (noto anche come versione 1703) e non è disponibile nelle versioni precedenti del sistema operativo.
I comportamenti aggiuntivi introdotti sono i seguenti:

Notifiche di modifica DPI della finestra figlio: nei contesti per monitor v2 l'intera struttura ad albero della finestra riceve una notifica di eventuali modifiche dpi che si verificano.
Ridimensionamento dell'area non client: tutte le finestre avranno automaticamente l'area non client disegnata in modo sensibile ai valori DPI. Le chiamate a EnableNonClientDpiScaling non sono necessarie.
Ridimensionamento dei menu Win32: tutti i menu NTUSER creati in contesti per monitor v2 verranno ridimensionati in modo da monitorare.
Ridimensionamento della finestra di dialogo: le finestre di dialogo Win32 create nei contesti per monitor v2 risponderanno automaticamente alle modifiche dpi.
Miglioramento della scalabilità dei controlli comctl32: vari controlli comctl32 hanno migliorato il comportamento di ridimensionamento DPI nei contesti per monitor v2.
Miglioramento del comportamento di tema: gli handle UxTheme aperti nel contesto di una finestra Per Monitor v2 funzioneranno in termini di DPI associato a tale finestra.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI non a conoscenza con una migliore qualità del contenuto basato su GDI. Questa modalità si comporta in modo analogo a DPI_AWARENESS_CONTEXT_UNAWARE, ma consente anche al sistema di migliorare automaticamente la qualità del rendering del testo e di altre primitive basate su GDI quando la finestra viene visualizzata su un monitor con valori DPI elevati.

Per altri dettagli, vedere Miglioramento dell'esperienza dpi elevata nelle app desktop basate su GDI.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED è stato introdotto nell'aggiornamento di ottobre 2018 di Windows 10 (noto anche come versione 1809).