pesan WM_MOUSEWHEEL

Dikirim ke jendela fokus saat roda mouse diputar. Fungsi DefWindowProc menyebarkan 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 .

#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.

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.

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.

Mengembalikan nilai

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.

Komentar

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 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.

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

Lihat juga

Referensi

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_Y_LPARAM

GET_WHEEL_DELTA_WPARAM

HIWORD

LOWORD

mouse_event

Konseptual

Input Mouse

Sumber Daya Lain

getSystemMetrics

MAKEPOINTS

POINTS

SystemParametersInfo