pesan WM_MOUSEWHEEL

  • Artikel

Dikirim ke jendela fokus saat roda mouse diputar. Fungsi DefWindowProc menyebarluaskan pesan ke induk jendela. Seharusnya tidak ada penerusan internal pesan, karena DefWindowProc menyebarkannya ke rantai induk sampai menemukan jendela yang memprosesnya.

Jendela menerima pesan ini melalui fungsi WindowProc-nya.

#define WM_MOUSEWHEEL                   0x020A

Parameter

wParam

Kata urutan tinggi menunjukkan jarak roda diputar, dinyatakan dalam kelipatan atau pembagian WHEEL_DELTA, yaitu 120. Nilai positif menunjukkan bahwa roda diputar ke depan, jauh dari pengguna; nilai negatif menunjukkan bahwa roda diputar mundur, ke arah pengguna.

Kata berurutan rendah menunjukkan apakah berbagai kunci virtual tidak berfungsi. Parameter ini bisa berupa satu atau beberapa nilai berikut.

Value Makna
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
 Tombol X pertama tidak berfungsi.
MK_XBUTTON2
0x0040
 Tombol X kedua tidak berfungsi.

lParam

Kata berurutan rendah menentukan koordinat x penunjuk, relatif terhadap sudut kiri atas layar.

Kata berurutan tinggi menentukan koordinat y penunjuk, relatif terhadap sudut kiri atas layar.

Nilai hasil

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.

Keterangan

Gunakan kode berikut untuk mendapatkan informasi dalam parameter wParam :

fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_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 nilai pengembalian dalam urutan rendah; koordinat y berada dalam pendek urutan 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 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.

Rotasi roda akan menjadi kelipatan WHEEL_DELTA, yang diatur pada 120. Ini adalah ambang batas untuk tindakan yang akan diambil, dan satu tindakan seperti itu (misalnya, menggulir satu kenaikan) harus terjadi untuk setiap delta.

Delta diatur ke 120 untuk memungkinkan Microsoft atau vendor lain membangun roda resolusi yang lebih halus (roda yang diputar bebas tanpa takik) untuk mengirim lebih banyak pesan per rotasi, tetapi dengan nilai yang lebih kecil di setiap pesan. Untuk menggunakan fitur ini, Anda dapat menambahkan nilai delta masuk hingga WHEEL_DELTA tercapai (sehingga untuk rotasi delta Anda mendapatkan respons yang sama), atau menggulir baris parsial sebagai respons terhadap pesan yang lebih sering. Anda juga dapat memilih granularitas gulir dan mengakumulasi delta hingga tercapai.

Perhatikan, tidak ada fwKeys untuk MSH_MOUSEWHEEL. Jika tidak, parameternya sama persis dengan untuk WM_MOUSEWHEEL.

Terserah aplikasi untuk meneruskan MSH_MOUSEWHEEL ke objek atau kontrol yang disematkan. Aplikasi diperlukan untuk mengirim pesan ke aplikasi OLE tersemat aktif. Adalah opsional bahwa aplikasi mengirimkannya ke kontrol berkemampuan roda dengan fokus. Jika aplikasi mengirim pesan ke kontrol, aplikasi dapat memeriksa nilai pengembalian untuk melihat apakah pesan diproses. Kontrol diperlukan untuk mengembalikan nilai TRUE jika mereka memproses pesan.

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

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_Y_LPARAM

GET_WHEEL_DELTA_WPARAM

KATA SANDI

LOWORD

mouse_event

Konseptual

Mouse Input

Sumber Daya Lainnya

GetSystemMetrics

MAKEPOINTS

POIN

SystemParametersInfo