Bagikan melalui


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