WM_POINTERWHEEL pesan

Artikel
06/22/2023

Diposting ke jendela dengan fokus keyboard latar depan saat roda gulir diputar.

Jendela menerima pesan ini melalui fungsi WindowProc-nya .

! [Penting]
Aplikasi desktop harus diketahui DPI. Jika aplikasi Anda tidak mengetahui DPI, koordinat layar yang terkandung dalam pesan penunjuk dan struktur terkait mungkin muncul tidak akurat karena virtualisasi DPI. Virtualisasi DPI menyediakan dukungan penskalaan otomatis untuk aplikasi yang tidak sadar DPI dan aktif secara default (pengguna dapat menonaktifkannya). Untuk informasi selengkapnya, lihat Menulis Aplikasi Win32 DPI Tinggi.

#define WM_POINTERWHEEL            0x024E

Parameter

wParam

Berisi pengidentifikasi penunjuk dan delta roda. Gunakan makro berikut untuk mengambil informasi ini.

GET_POINTERID_WPARAM(wParam): pengidentifikasi penunjuk.

GET_WHEEL_DELTA_WPARAM(wParam): delta roda sebagai nilai pendek yang ditandatangani.

lParam

Berisi lokasi titik penunjuk.

Catatan

Karena pointer dapat melakukan kontak dengan perangkat melalui area yang tidak sepele, lokasi titik ini mungkin merupakan penyederhanaan area pointer yang lebih kompleks. Jika memungkinkan, aplikasi harus menggunakan informasi area pointer lengkap alih-alih lokasi titik.

Gunakan makro berikut untuk mengambil koordinat layar fisik titik tersebut.

GET_X_LPARAM(lParam): koordinat x (titik horizontal).
GET_Y_LPARAM(lParam): koordinat y (titik vertikal).

Nilai kembali

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.

Jika aplikasi tidak memproses pesan ini, aplikasi harus memanggil DefWindowProc.

Keterangan

Untuk mengambil unit gulir roda, gunakan inputData yang diajukan dari struktur POINTER_INFO yang dikembalikan dengan memanggil fungsi GetPointerInfo . Bidang ini berisi nilai yang ditandatangani dan dinyatakan dalam kelipatan WHEEL_DELTA. Nilai positif menunjukkan rotasi ke depan dan nilai negatif menunjukkan rotasi mundur.

Perhatikan bahwa input roda dapat dikirimkan meskipun kursor mouse terletak di luar jendela aplikasi s. Pesan roda dikirimkan dengan cara yang sangat mirip dengan input keyboard. Jendela fokus antrean pesan foregournd menerima pesan roda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

Pesan

Share via