Share via

pesan WM_PARENTNOTIFY

  • Artikel

Dikirim ke jendela saat tindakan signifikan terjadi pada jendela turunan. Pesan ini sekarang diperluas untuk menyertakan peristiwa WM_POINTERDOWN. Ketika jendela anak sedang dibuat, sistem mengirim WM_PARENTNOTIFY tepat sebelum fungsi CreateWindow atau CreateWindowEx yang membuat jendela kembali. Ketika jendela anak sedang dihancurkan, sistem mengirim pesan sebelum pemrosesan apa pun untuk menghancurkan jendela terjadi.

Jendela menerima pesan ini melalui fungsi WindowProc-nya.

! [Penting]
Aplikasi desktop harus diketahui DPI. Jika aplikasi Anda tidak mengetahui DPI, koordinat layar yang terkandung dalam pesan penunjuk dan struktur terkait mungkin muncul tidak akurat karena virtualisasi DPI. Virtualisasi DPI menyediakan dukungan penskalaan otomatis untuk aplikasi yang tidak diketahui DPI dan aktif secara default (pengguna dapat menonaktifkannya). Untuk informasi selengkapnya, lihat Menulis Aplikasi Win32 DPI Tinggi.

#define WM_PARENTNOTIFY             0x0210

Parameter

wParam

Kata berurutan rendah dari wParam menentukan peristiwa tempat induk diberi tahu. Nilai kata berurutan tinggi tergantung pada nilai kata berurutan rendah. Parameter ini bisa menjadi salah satu nilai berikut.

LOWORD(wParam) Makna
WM_CREATE
0x0001
 Jendela anak sedang dibuat.
HIWORD(wParam) adalah pengidentifikasi jendela anak.
lParam adalah pegangan ke jendela anak.
WM_DESTROY
0x0002
 Jendela anak sedang dihancurkan.
HIWORD(wParam) adalah pengidentifikasi jendela anak.
lParam adalah pegangan ke jendela anak.
WM_LBUTTONDOWN
0x0201
 Pengguna telah menempatkan kursor di atas jendela anak dan telah mengklik tombol mouse kiri.
HIWORD(wParam) tidak ditentukan.
lParam adalah koordinat x kursor adalah kata urutan rendah, dan koordinat y kursor adalah kata urutan tinggi.
WM_MBUTTONDOWN
0x0207
 Pengguna telah menempatkan kursor di atas jendela anak dan telah mengklik tombol mouse tengah.
HIWORD(wParam) tidak ditentukan.
lParam adalah koordinat x kursor adalah kata urutan rendah, dan koordinat y kursor adalah kata urutan tinggi.
WM_RBUTTONDOWN
0x0204
 Pengguna telah menempatkan kursor di atas jendela anak dan telah mengklik tombol kanan mouse.
HIWORD(wParam) tidak ditentukan.
lParam adalah koordinat x kursor adalah kata urutan rendah, dan koordinat y kursor adalah kata urutan tinggi.
WM_XBUTTONDOWN
0x020B
 Pengguna telah menempatkan kursor di atas jendela anak dan telah mengklik tombol X pertama atau kedua.
HIWORD(wParam) menunjukkan tombol mana yang ditekan. Parameter ini bisa menjadi salah satu nilai berikut: XBUTTON1 atau XBUTTON2.
lParam adalah koordinat x kursor adalah kata urutan rendah, dan koordinat y kursor adalah kata urutan tinggi.
WM_POINTERDOWN
0x0246
 Penunjuk telah melakukan kontak dengan jendela anak.
HIWORD(wParam) berisi pengidentifikasi pointer yang menghasilkan peristiwa WM_POINTERDOWN .

lParam

Berisi lokasi titik penunjuk.

Catatan

Karena pointer dapat melakukan kontak dengan perangkat melalui area non-sepele, lokasi titik ini mungkin merupakan penyederhanaan area pointer yang lebih kompleks. Jika memungkinkan, aplikasi harus menggunakan informasi area pointer lengkap alih-alih lokasi titik.

Gunakan makro berikut untuk mengambil koordinat layar fisik titik tersebut.

  • GET_X_LPARAM(lParam): koordinat x (titik horizontal).
  • GET_Y_LPARAM(lParam): koordinat y (titik vertikal).

Nilai hasil

Jika aplikasi memproses pesan ini, aplikasi akan mengembalikan nol.

Jika aplikasi tidak memproses pesan ini, aplikasi memanggil DefWindowProc.

Keterangan

Pesan ini juga dikirim ke semua jendela leluhur jendela anak, termasuk jendela tingkat atas.

Semua jendela anak, kecuali yang memiliki gaya jendela WS_EX_NOPARENTNOTIFY diperluas, kirim pesan ini ke jendela induk mereka. Secara default, jendela anak dalam kotak dialog memiliki gaya WS_EX_NOPARENTNOTIFY, kecuali fungsi CreateWindowEx dipanggil untuk membuat jendela anak tanpa gaya ini.

Pemberitahuan ini memberi jendela leluhur jendela anak kesempatan untuk memeriksa informasi penunjuk dan, jika diperlukan, menangkap penunjuk menggunakan fungsi penangkapan pointer.

Persyaratan

Persyaratan Value
Klien minimum yang didukung
 Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2012 [hanya aplikasi desktop]
Header
Winuser.h (termasuk Windows.h)

Baca juga

Pesan

CreateWindow

CreateWindowEx

KATA SANDI

LOWORD

WM_CREATE

WM_DESTROY

WM_LBUTTONDOWN

WM_MBUTTONDOWN

WM_RBUTTONDOWN

WM_XBUTTONDOWN