pesan WM_NCXBUTTONUP
Diposting saat pengguna merilis tombol X pertama atau kedua saat kursor berada di area nonkelola jendela. Pesan ini diposting ke jendela yang berisi kursor. Jika jendela telah mengambil mouse, pesan ini tidak diposting.
Jendela menerima pesan ini melalui fungsi WindowProc-nya.
#define WM_NCXBUTTONUP 0x00AC
Parameter
-
wParam
-
Kata berurutan rendah menentukan nilai hit-test yang dikembalikan oleh fungsi DefWindowProc dari pemrosesan pesan WM_NCHITTEST. Untuk daftar nilai uji hit, lihat WM_NCHITTEST.
Kata berurutan tinggi menunjukkan tombol mana yang dirilis. Ini bisa menjadi salah satu nilai berikut.
Value Makna - XBUTTON1
- 0x0001
Tombol X pertama dirilis. - XBUTTON2
- 0x0002
Tombol X kedua dirilis. -
lParam
-
Penunjuk ke struktur POINTS yang berisi koordinat kursor x dan y. Koordinat relatif terhadap sudut kiri atas layar.
Nilai hasil
Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan TRUE. Untuk informasi selengkapnya tentang memproses nilai yang dikembalikan, lihat bagian Keterangan.
Keterangan
Gunakan kode berikut untuk mendapatkan informasi dalam parameter wParam .
nHittest = GET_NCHITTEST_WPARAM(wParam);
fwButton = GET_XBUTTON_WPARAM(wParam);
Anda juga dapat menggunakan kode berikut untuk mendapatkan koordinat x- dan y dari lParam:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Penting
Jangan gunakan makro LOWORD atau HIWORD untuk mengekstrak koordinat x- dan y- dari posisi kursor karena makro ini mengembalikan hasil yang salah pada sistem dengan beberapa monitor. Sistem dengan beberapa monitor dapat memiliki koordinat x-dan y- negatif, dan LOWORD dan HIWORD memperlakukan koordinat sebagai jumlah yang tidak ditandatangani.
Secara default, fungsi DefWindowProc menguji titik yang ditentukan untuk mendapatkan posisi kursor dan melakukan tindakan yang sesuai. Jika sesuai, pesan WM_SYSCOMMAND akan dikirim ke jendela.
Tidak seperti pesan WM_NCLBUTTONUP, WM_NCMBUTTONUP, dan WM_NCRBUTTONUP, aplikasi harus mengembalikan TRUE dari pesan ini jika memprosesnya. Melakukannya akan memungkinkan perangkat lunak yang mensimulasikan pesan ini pada sistem Windows lebih awal dari Windows 2000 untuk menentukan apakah prosedur jendela memproses pesan atau disebut DefWindowProc untuk memprosesnya.
Persyaratan
| Persyaratan | Value |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|
Baca juga
-
Referensi
-
Konseptual
-
Sumber Daya Lainnya