pesan WM_HSCROLL

Pesan WM_HSCROLL dikirim ke jendela saat peristiwa gulir terjadi di bilah gulir horizontal standar jendela. Pesan ini juga dikirim ke pemilik kontrol bilah gulir horizontal saat peristiwa gulir terjadi di kontrol.

Jendela menerima pesan ini melalui fungsi WindowProc-nya.

WM_HSCROLL

    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. Kata ini bisa menjadi salah satu nilai berikut.

Value	Makna
SB_ENDSCROLL	Mengakhiri gulir.
SB_LEFT	Menggulir ke kiri atas.
SB_RIGHT	Menggulir ke kanan bawah.
SB_LINELEFT	Gulir ke kiri satu unit.
SB_LINERIGHT	Menggulir ke kanan satu unit.
SB_PAGELEFT	Menggulir ke kiri dengan lebar jendela.
SB_PAGERIGHT	Menggulir ke kanan menurut lebar jendela.
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.

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_HSCROLL hanya membawa 16 bit data posisi kotak gulir. Dengan demikian, aplikasi yang hanya mengandalkan WM_HSCROLL (dan WM_VSCROLL) 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 dari 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 (trackbar)

WM_VSCROLL