pesan WM_VSCROLL
Pesan WM_VSCROLL dikirim ke jendela saat peristiwa gulir terjadi di bilah gulir vertikal standar jendela. Pesan ini juga dikirim ke pemilik kontrol bilah gulir vertikal saat peristiwa gulir terjadi di kontrol.
Jendela menerima pesan ini melalui fungsi WindowProc-nya.
WM_VSCROLL
WPARAM wParam
LPARAM lParam;
Parameter
-
wParam
-
HIWORD menentukan posisi kotak gulir saat ini jika LOWORD SB_THUMBPOSITION atau SB_THUMBTRACK; jika tidak, kata ini tidak digunakan.
LOWORD menentukan nilai bilah gulir yang menunjukkan permintaan gulir pengguna. Parameter ini bisa menjadi salah satu nilai berikut.
Value Makna - SB_BOTTOM
Menggulir ke kanan bawah. - SB_ENDSCROLL
Mengakhiri gulir. - SB_LINEDOWN
Menggulir satu baris ke bawah. - SB_LINEUP
Menggulir satu baris ke atas. - SB_PAGEDOWN
Menggulir satu halaman ke bawah. - SB_PAGEUP
Menggulir satu halaman ke atas. - SB_THUMBPOSITION
Pengguna telah menyeret kotak gulir (jempol) dan melepaskan tombol mouse. HIWORD menunjukkan posisi kotak gulir di akhir operasi seret. - SB_THUMBTRACK
Pengguna menyeret kotak gulir. Pesan ini dikirim berulang kali hingga pengguna merilis tombol mouse. HIWORD menunjukkan posisi kotak gulir telah diseret. - SB_TOP
Menggulir ke kiri atas. -
lParam
-
Jika pesan dikirim oleh kontrol bilah gulir, parameter ini adalah handel ke kontrol bilah gulir. Jika pesan dikirim oleh bilah gulir standar, parameter ini adalah NULL.
Nilai hasil
Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.
Keterangan
Kode permintaan SB_THUMBTRACK biasanya digunakan oleh aplikasi yang memberikan umpan balik saat pengguna menyeret kotak gulir.
Jika aplikasi menggulir konten jendela, aplikasi juga harus mengatur ulang posisi kotak gulir dengan menggunakan fungsi SetScrollPos.
Perhatikan bahwa pesan WM_VSCROLL hanya membawa 16 bit data posisi kotak gulir. Dengan demikian, aplikasi yang hanya mengandalkan WM_VSCROLL (dan WM_HSCROLL) untuk data posisi gulir memiliki nilai posisi maksimum praktis 65.535.
Namun, karena fungsi SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos, dan GetScrollRange mendukung data posisi bilah gulir 32-bit, ada cara untuk menghindari hambatan 16-bit pesan WM_HSCROLL dan WM_VSCROLL. Lihat GetScrollInfo untuk deskripsi teknik.
Persyaratan
Persyaratan | Value |
---|---|
Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
Header |
|