SBM_GETSCROLLINFO pesan
Pesan SBM_GETSCROLLINFO dikirim untuk mengambil parameter bilah gulir.
Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebaliknya, mereka harus menggunakan fungsi GetScrollInfo . Jendela menerima pesan ini melalui fungsi WindowProc-nya . Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi GetScrollInfo berfungsi dengan baik.
Parameter
-
wParam
-
Parameter ini tidak digunakan.
-
lParam
-
Penunjuk ke struktur SCROLLINFO . Sebelum memanggil GetScrollInfo, atur anggota cbSize struktur ke sizeof (SCROLLINFO), dan atur anggota fMask untuk menentukan parameter bilah gulir yang akan diambil. Sebelum kembali, pesan menyalin parameter yang ditentukan ke anggota struktur yang sesuai.
Anggota fMask bisa menjadi satu atau beberapa nilai berikut.
Nilai Makna - SIF_ALL
Kombinasi SIF_PAGE, SIF_POS, SIF_RANGE, dan SIF_TRACKPOS. - SIF_PAGE
Menyalin halaman gulir ke anggota nPage. - SIF_POS
Menyalin posisi gulir ke anggota nPos. - SIF_RANGE
Menyalin rentang gulir ke anggota nMin dan nMax. - SIF_TRACKPOS
Menyalin posisi pelacakan kotak gulir saat ini ke anggota nTrackPos.
Nilai kembali
Jika pesan mengambil nilai apa pun, nilai yang dikembalikan adalah TRUE; jika tidak, itu adalah FALSE.
Keterangan
Pesan yang menunjukkan posisi bilah gulir, WM_HSCROLL dan WM_VSCROLL, hanya menyediakan 16 bit data posisi. Namun, struktur SCROLLINFO yang digunakan oleh SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo, dan SetScrollInfo menyediakan 32 bit data posisi bilah gulir. Anda dapat menggunakan pesan dan fungsi ini saat memproses pesan WM_HSCROLL atau WM_VSCROLL untuk mendapatkan data posisi bilah gulir 32-bit.
Untuk mendapatkan posisi 32-bit kotak gulir (jempol) selama kode permintaan SB_THUMBTRACK dalam pesan WM_HSCROLL atau WM_VSCROLL , kirim SBM_GETSCROLLINFO dengan nilai SIF_TRACKPOS di anggota fMask struktur SCROLLINFO . Pesan mengembalikan posisi pelacakan kotak gulir di anggota nTrackPos struktur SCROLLINFO . Ini memungkinkan Anda untuk mendapatkan posisi kotak gulir saat pengguna memindahkannya. Atau, Anda dapat menggunakan fungsi GetScrollInfo untuk mendapatkan informasi yang sama.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Header |
|