pesan WM_XBUTTONDOWN

Diposting saat pengguna menekan XBUTTON1 atau XBUTTON2 saat kursor berada di area klien jendela. Jika mouse tidak diambil, pesan diposting ke jendela di bawah kursor. Jika tidak, pesan diposting ke jendela yang telah mengambil mouse.

Jendela menerima pesan ini melalui fungsi WindowProc .

#define WM_XBUTTONDOWN                  0x020B

Parameter

wParam

Kata berurutan rendah menunjukkan apakah berbagai kunci virtual tidak berfungsi. Ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Arti
MK_CONTROL 0x0008	Tombol CTRL tidak berfungsi.
MK_LBUTTON 0x0001	Tombol mouse kiri tidak berfungsi.
MK_MBUTTON 0x0010	Tombol mouse tengah tidak berfungsi.
MK_RBUTTON 0x0002	Tombol kanan mouse tidak berfungsi.
MK_SHIFT 0x0004	Tombol SHIFT tidak berfungsi.
MK_XBUTTON1 0x0020	XBUTTON1 tidak berfungsi.
MK_XBUTTON2 0x0040	XBUTTON2 tidak berfungsi.

Kata berurutan tinggi menunjukkan tombol mana yang diklik. Ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
XBUTTON1 0x0001	XBUTTON1 diklik.
XBUTTON2 0x0002	XBUTTON2 diklik.

lParam

Kata berurutan rendah menentukan koordinat x kursor. Koordinat relatif terhadap sudut kiri atas area klien.

Kata urutan tinggi menentukan koordinat y kursor. Koordinat relatif terhadap sudut kiri atas area klien.

Mengembalikan nilai

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan TRUE. Untuk informasi selengkapnya tentang memproses nilai yang dikembalikan, lihat bagian Keterangan.

Komentar

Windows mendukung tikus dengan hingga lima tombol: kiri, tengah, dan kanan, ditambah dua tombol tambahan yang disebut XBUTTON1 dan XBUTTON2. Tombol XBUTTON1 dan XBUTTON2 sering terletak di sisi mouse, di dekat dasar. Tombol tambahan ini tidak ada pada semua tikus. Jika ada, tombol XBUTTON1 dan XBUTTON2 sering dipetakan ke fungsi aplikasi, seperti navigasi maju dan mundur di browser Web.

Gunakan kode berikut untuk mendapatkan informasi dalam parameter wParam :

fwKeys = GET_KEYSTATE_WPARAM (wParam); 
fwButton = GET_XBUTTON_WPARAM (wParam);

Gunakan kode berikut untuk mendapatkan posisi horizontal dan vertikal:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Seperti disebutkan di atas, koordinat x berada dalam pendek rendah dari nilai pengembalian; koordinat y berada dalam pendek berurutan tinggi (keduanya mewakili nilai yang ditandatangani karena dapat mengambil nilai negatif pada sistem dengan beberapa monitor). Jika nilai pengembalian ditetapkan ke variabel, Anda dapat menggunakan makro MAKEPOINTS untuk mendapatkan struktur POINTS dari nilai pengembalian. Anda juga dapat menggunakan makro GET_X_LPARAM atau GET_Y_LPARAM untuk mengekstrak koordinat x atau y.

Tidak seperti pesan WM_LBUTTONDOWN, WM_MBUTTONDOWN, dan WM_RBUTTONDOWN, aplikasi harus mengembalikan TRUE dari pesan ini jika memprosesnya. Melakukannya memungkinkan perangkat lunak yang mensimulasikan pesan ini pada sistem Windows yang lebih lama dari Windows 2000 untuk menentukan apakah prosedur jendela memproses pesan atau disebut DefWindowProc untuk memprosesnya.

Persyaratan

Lihat juga

Referensi

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_XBUTTON_WPARAM

GET_Y_LPARAM

GetCapture

SetCapture

WM_XBUTTONDBLCLK

WM_XBUTTONUP

Konseptual

Input Mouse

Sumber Daya Lain

MAKEPOINTS

POINTS