pesan WM_NCPOINTERUPDATE

Diposting untuk memberikan pembaruan pada pointer yang melakukan kontak melalui area non-klien jendela atau ketika kontak yang tidak ditangkap yang mengarah ke area non-klien jendela. Saat penunjuk mengarah, pesan menargetkan jendela mana pun yang kebetulan penunjuk berakhir. Saat penunjuk bersentuhan dengan permukaan, penunjuk secara implisit ditangkap ke jendela tempat pointer melakukan kontak dan jendela tersebut terus menerima input untuk pointer sampai putus kontak.

Jika jendela telah mengambil penunjuk ini, pesan ini tidak diposting. Sebagai gantinya, WM_POINTERUPDATE diposting ke jendela yang telah mengambil pointer ini.

! [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_NCPOINTERUPDATE                 0x0241

Parameter

wParam

Berisi pengidentifikasi pointer dan informasi tambahan. Gunakan makro berikut untuk mengambil informasi ini.

GET_POINTERID_WPARAM(wParam): pengidentifikasi penunjuk

HIWORD(wParam): nilai hit-test yang dikembalikan dari pemrosesan pesan WM_NCHITTEST .

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 harus mengembalikan nol.

Jika aplikasi tidak memproses pesan ini, aplikasi harus memanggil DefWindowProc.

Keterangan

Jika aplikasi tidak memproses pesan ini, DefWindowProc dapat melakukan satu atau beberapa tindakan sistem tergantung pada hasil hit-test yang disertakan dalam pesan. Biasanya, aplikasi tidak perlu menangani pesan ini.

Persyaratan

Baca juga

Pesan