handel DPI_AWARENESS_CONTEXT

Artikel
06/13/2023

Mengidentifikasi konteks kesadaran untuk jendela.

Sintaks

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

Konstanta

DPI_AWARENESS_CONTEXT_UNAWARE

DPI tidak menyadari. Jendela ini tidak menskalakan perubahan DPI dan selalu diasumsikan memiliki faktor skala 100% (96 DPI). Ini akan secara otomatis diskalakan oleh sistem pada pengaturan DPI lainnya.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

DPI sistem sadar. Jendela ini tidak menskalakan perubahan DPI. Ini akan meminta DPI sekali dan menggunakan nilai tersebut selama masa proses. Jika DPI berubah, proses tidak akan menyesuaikan dengan nilai DPI baru. Ini akan secara otomatis ditingkatkan atau diturunkan oleh sistem ketika DPI berubah dari nilai sistem.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

Per monitor DPI sadar. Jendela ini memeriksa DPI saat dibuat dan menyesuaikan faktor skala setiap kali DPI berubah. Proses ini tidak secara otomatis diskalakan oleh sistem.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

Juga dikenal sebagai Per Monitor v2. Kemajuan atas mode kesadaran DPI per monitor asli, yang memungkinkan aplikasi mengakses perilaku penskalaan baru terkait DPI berdasarkan jendela per tingkat atas.
Per Monitor v2 tersedia di Pembaruan pembuat Windows 10, dan tidak tersedia pada versi sistem operasi yang lebih lama.
Perilaku tambahan yang diperkenalkan adalah sebagai berikut:

Pemberitahuan perubahan DPI jendela anak - Dalam konteks Per Monitor v2, seluruh pohon jendela diberi tahu tentang perubahan DPI apa pun yang terjadi.
Penskalaan area non-klien - Semua jendela akan secara otomatis memiliki area non-klien mereka yang digambar dengan cara Sensitif DPI. Panggilan ke EnableNonClientDpiScaling tidak perlu.
Penskalaan menu Win32 - Semua menu NTUSER yang dibuat dalam konteks Per Monitor v2 akan diskalakan dengan cara per monitor.
Dialog Scaling - Dialog Win32 yang dibuat dalam konteks Per Monitor v2 akan secara otomatis merespons perubahan DPI.
Peningkatan penskalaan kontrol comctl32 - Berbagai kontrol comctl32 telah meningkatkan perilaku penskalaan DPI dalam konteks Per Monitor v2.
Perilaku tema yang ditingkatkan - Handel UxTheme yang dibuka dalam konteks jendela Per Monitor v2 akan beroperasi dalam hal DPI yang terkait dengan jendela tersebut.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI tidak menyadari dengan peningkatan kualitas konten berbasis GDI. Mode ini bertingkah mirip dengan DPI_AWARENESS_CONTEXT_UNAWARE, tetapi juga memungkinkan sistem untuk secara otomatis meningkatkan kualitas penyajian teks dan primitif berbasis GDI lainnya ketika jendela ditampilkan pada monitor DPI tinggi.

Untuk detail selengkapnya, lihat Meningkatkan pengalaman DPI tinggi di aplikasi Desktop berbasis GDI.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED diperkenalkan dalam pembaruan Windows 10 Oktober 2018 (juga dikenal sebagai versi 1809).