pesan WM_XBUTTONDBLCLK

Diposting saat pengguna mengklik dua kali tombol X pertama atau kedua 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-nya .

#define WM_XBUTTONDBLCLK                0x020D

Parameter

wParam

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

Nilai Makna
MK_CONTROL
0x0008
Tombol CTRL tidak berfungsi.
MK_LBUTTON
0x0001
Tombol kiri mouse 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
Tombol X pertama tidak berfungsi.
MK_XBUTTON2
0x0040
Tombol X kedua tidak berfungsi.

Kata urutan tinggi menunjukkan tombol mana yang diklik dua kali. Ini bisa menjadi salah satu nilai berikut.

Nilai Makna
XBUTTON1
0x0001
Tombol X pertama diklik dua kali.
XBUTTON2
0x0002
Tombol X kedua diklik dua kali.

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.

Keterangan

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 kekurangan urutan rendah dari nilai yang dikembalikan; koordinat y berada dalam pendek urutan tinggi (keduanya mewakili nilai yang ditandatangani karena dapat mengambil nilai negatif pada sistem dengan beberapa monitor). Jika nilai yang dikembalikan ditetapkan ke variabel, Anda dapat menggunakan makro MAKEPOINTS untuk mendapatkan struktur POINTS dari nilai yang dikembalikan. Anda juga dapat menggunakan makro GET_X_LPARAM atau GET_Y_LPARAM untuk mengekstrak koordinat x- atau y.

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.

Hanya jendela yang memiliki gaya CS_DBLCLKS yang dapat menerima pesan WM_XBUTTONDBLCLK , yang dihasilkan sistem setiap kali pengguna menekan, melepaskan, dan kembali menekan tombol X dalam batas waktu klik ganda sistem. Mengklik dua kali salah satu tombol ini benar-benar menghasilkan empat pesan: WM_XBUTTONDOWN, WM_XBUTTONUP, WM_XBUTTONDBLCLK, dan WM_XBUTTONUP lagi.

Tidak seperti pesan WM_LBUTTONDBLCLK, WM_MBUTTONDBLCLK, dan WM_RBUTTONDBLCLK , 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 Nilai
Klien minimum yang didukung
Windows 2000 Professional [khusus aplikasi desktop]
Server minimum yang didukung
Windows 2000 Server [hanya aplikasi desktop]
Header
Winuser.h (termasuk Windowsx.h)

Lihat juga

Referensi

DefWindowProc

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_XBUTTON_WPARAM

GET_Y_LPARAM

GetCapture

GetDoubleClickTime

SetDoubleClickTime

WM_XBUTTONDOWN

WM_XBUTTONUP

Konseptual

Mouse Input

Sumber Daya Lainnya

MAKEPOINTS

POIN