pesan WM_NCXBUTTONUP

Artikel
01/23/2025

Diposting saat pengguna merilis 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_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.

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

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

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 yang lebih lama dari Windows 2000 untuk menentukan apakah prosedur jendela memproses pesan atau disebut DefWindowProc untuk memprosesnya.

Persyaratan

Syarat	Nilai
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)

Lihat juga

Referensi
DefWindowProc
GET_X_LPARAM
GET_Y_LPARAM
WM_NCHITTEST
WM_NCXBUTTONDBLCLK
WM_NCXBUTTONDOWN
WM_SYSCOMMAND
Konseptual
Input Mouse
Sumber Daya Lain
MAKEPOINTS
POINTS

Bagikan melalui