pesan WM_NCXBUTTONDOWN

Diposting saat pengguna menekan 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_NCXBUTTONDOWN                0x00AB

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 ditekan. Ini bisa menjadi salah satu nilai berikut.

Value	Makna
XBUTTON1 0x0001	Tombol X pertama ditekan.
XBUTTON2 0x0002	Tombol X kedua ditekan.

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_NCLBUTTONDOWN, WM_NCMBUTTONDOWN, dan WM_NCRBUTTONDOWN, 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	Winuser.h (termasuk Windowsx.h)

Baca juga

Referensi

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

WM_NCHITTEST

WM_NCXBUTTONDBLCLK

WM_NCXBUTTONUP

WM_SYSCOMMAND

Konseptual

Mouse Input

Sumber Daya Lainnya

MAKEPOINTS

POIN