Fungsi SetThreadDpiHostingBehavior (winuser.h)

  • Artikel

Mengatur DPI_HOSTING_BEHAVIOR utas. Perilaku ini memungkinkan jendela yang dibuat di utas untuk menghosting jendela anak dengan DPI_AWARENESS_CONTEXT yang berbeda.

Sintaks

DPI_HOSTING_BEHAVIOR SetThreadDpiHostingBehavior(
  DPI_HOSTING_BEHAVIOR value
);

Parameter

value

Nilai DPI_HOSTING_BEHAVIOR baru untuk utas saat ini.

Nilai kembali

DPI_HOSTING_BEHAVIOR sebelumnya untuk utas. Jika perilaku hosting yang diteruskan tidak valid, utas tidak akan diperbarui dan nilai yang dikembalikan akan DPI_HOSTING_BEHAVIOR_INVALID. Anda dapat menggunakan nilai ini untuk memulihkan DPI_HOSTING_BEHAVIOR lama setelah menimpanya dengan nilai yang telah ditentukan sebelumnya.

Keterangan

DPI_HOSTING_BEHAVIOR memungkinkan perilaku hosting konten campuran, yang memungkinkan jendela induk yang dibuat di utas untuk menghosting jendela anak dengan nilai DPI_AWARENESS_CONTEXT yang berbeda. Properti ini hanya memengaruhi jendela baru yang dibuat dalam utas ini saat perilaku hosting campuran aktif. Jendela induk dengan perilaku hosting ini dapat menghosting jendela anak dengan nilai DPI_AWARENESS_CONTEXT yang berbeda, terlepas dari apakah jendela anak mengaktifkan perilaku hosting campuran.

Perilaku hosting ini tidak memungkinkan jendela dengan nilai DPI_AWARENESS_CONTEXT per monitor dihosting sampai jendela dengan nilai sistem DPI_AWARENESS_CONTEXT atau tidak menyadari.

Untuk menghindari hasil yang tidak terduga, DPI_HOSTING_BEHAVIOR utas harus diubah untuk mendukung perilaku hosting campuran hanya saat membuat jendela baru yang perlu mendukung perilaku tersebut. Setelah jendela tersebut dibuat, perilaku hosting harus dialihkan kembali ke nilai defaultnya.

API ini digunakan untuk mengubah DPI_HOSTING_BEHAVIOR utas dari nilai defaultnya. Ini hanya diperlukan jika aplikasi Anda perlu menghosting jendela anak dari plugin dan komponen pihak ketiga yang tidak mendukung konteks per-monitor-aware. Ini kemungkinan besar terjadi jika Anda memperbarui aplikasi kompleks untuk mendukung perilaku DPI_AWARENESS_CONTEXT per monitor.

Mengaktifkan perilaku hosting campuran tidak akan secara otomatis menyesuaikan DPI_AWARENESS_CONTEXT utas agar kompatibel dengan konten warisan. Konteks kesadaran utas masih harus diubah secara manual sebelum jendela baru dibuat untuk menghosting konten tersebut.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1803 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h
Pustaka User32.lib
DLL User32.dll

Lihat juga

DPI_HOSTING_BEHAVIOR

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior