pesan WM_VSCROLL

  • Artikel

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
Winuser.h (termasuk Windows.h)

Baca juga

Referensi

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL (Trackbar)