pesan WM_NCXBUTTONDBLCLK

Diposting saat pengguna mengklik dua kali baik XBUTTON1 atau XBUTTON2 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 .

#define WM_NCXBUTTONDBLCLK              0x00AD

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

Nilai	Arti
XBUTTON1 0x0001	XBUTTON1 diklik ganda..
XBUTTON2 0x0002	XBUTTON2 kedua diklik dua kali.

lParam

Penunjuk ke struktur POINTS yang berisi koordinat x- dan y kursor. Koordinat relatif terhadap sudut kiri atas layar.

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 .

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); 

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.

Jendela tidak perlu memiliki gaya CS_DBLCLKS untuk menerima pesan WM_NCXBUTTONDBLCLK. Sistem menghasilkan pesan WM_NCXBUTTONDBLCLK ketika pengguna menekan, merilis, dan kembali menekan XBUTTON dalam batas waktu klik ganda sistem. Mengklik dua kali salah satu tombol ini benar-benar menghasilkan empat pesan: WM_NCXBUTTONDOWN, WM_NCXBUTTONUP, WM_NCXBUTTONDBLCLK, dan WM_NCXBUTTONUP lagi.

Tidak seperti pesan WM_NCLBUTTONDBLCLK, WM_NCMBUTTONDBLCLK, dan WM_NCRBUTTONDBLCLK, aplikasi harus mengembalikan TRUE dari pesan ini jika memprosesnya. Melakukannya akan 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

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

WM_NCHITTEST

WM_NCXBUTTONDOWN

WM_NCXBUTTONUP

WM_SYSCOMMAND

Konseptual

Input Mouse

Sumber Daya Lain

MAKEPOINTS

POINTS