Bagikan melalui


Fungsi SetScrollInfo (winuser.h)

Fungsi SetScrollInfo mengatur parameter bilah gulir, termasuk posisi gulir minimum dan maksimum, ukuran halaman, dan posisi kotak gulir (jempol). Fungsi ini juga menggambar ulang bilah gulir, jika diminta.

Sintaks

int SetScrollInfo(
  [in] HWND          hwnd,
  [in] int           nBar,
  [in] LPCSCROLLINFO lpsi,
  [in] BOOL          redraw
);

Parameter

[in] hwnd

Jenis: HWND

Tangani ke kontrol bilah gulir atau jendela dengan bilah gulir standar, tergantung pada nilai parameter fnBar .

[in] nBar

Jenis: int

Menentukan jenis bilah gulir yang akan diatur parameternya. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
SB_CTL
Mengatur parameter kontrol bilah gulir. Parameter hwnd harus menjadi handel ke kontrol bilah gulir.
SB_HORZ
Mengatur parameter bilah gulir horizontal standar jendela.
SB_VERT
Mengatur parameter bilah gulir vertikal standar jendela.

[in] lpsi

Jenis: LPCSCROLLINFO

Penunjuk ke struktur SCROLLINFO . Sebelum memanggil SetScrollInfo, atur anggota cbSize struktur ke sizeof (SCROLLINFO), atur anggota fMask untuk menunjukkan parameter yang akan diatur, dan tentukan nilai parameter baru di anggota yang sesuai.

Anggota fMask bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
SIF_DISABLENOSCROLL
Menonaktifkan bilah gulir alih-alih menghapusnya, jika parameter baru bilah gulir membuat bilah gulir tidak perlu.
SIF_PAGE
Mengatur halaman gulir ke nilai yang ditentukan dalam anggota nPage struktur SCROLLINFO yang diarahkan oleh lpsi.
SIF_POS
Mengatur posisi gulir ke nilai yang ditentukan dalam anggota nPos struktur SCROLLINFO yang ditujukkan oleh lpsi.
SIF_RANGE
Mengatur rentang gulir ke nilai yang ditentukan dalam anggota nMin dan nMax dari struktur SCROLLINFO yang ditujukkan oleh lpsi.

[in] redraw

Jenis: BOOL

Menentukan apakah bilah gulir digambar ulang untuk mencerminkan perubahan pada bilah gulir. Jika parameter ini TRUE, bilah gulir digambar ulang, jika tidak, parameter tersebut tidak digambar ulang.

Mengembalikan nilai

Jenis: int

Nilai yang dikembalikan adalah posisi kotak gulir saat ini.

Keterangan

Fungsi SetScrollInfo melakukan pemeriksaan rentang pada nilai yang ditentukan oleh anggota nPage dan nPos dari struktur SCROLLINFO . Anggota nPage harus menentukan nilai dari 0 hingga nMax - nMin +1. Anggota nPos harus menentukan nilai antara nMin dan nMax - max( nPage– 1, 0). Jika salah satu nilai berada di luar rentangnya, fungsi mengaturnya ke nilai yang hanya berada dalam rentang.

Jika parameter fnBar SB_CTL dan jendela yang ditentukan oleh parameter hwnd bukan kontrol bilah gulir sistem, sistem mengirim pesan SBM_SETSCROLLINFO ke jendela untuk mengatur informasi bilah gulir (Sistem dapat mengoptimalkan pesan untuk SBM_SETPOS atau SBM_SETRANGE jika permintaan hanya untuk posisi atau rentang). Ini memungkinkan SetScrollInfo beroperasi pada kontrol kustom yang meniru bilah gulir. Jika jendela tidak menangani SBM_SETSCROLLINFO (atau pesan SBM_SETPOS yang dioptimalkan atau pesan SBM_SETRANGE ), maka fungsi SetScrollInfo gagal.

Misalnya, lihat Menggulir Teks dengan Pesan WM_PAINT.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h (sertakan Windows.h)
Pustaka User32.lib
DLL User32.dll
Set API ext-ms-win-ntuser-misc-l1-2-0 (diperkenalkan di Windows 8.1)

Lihat juga

GetScrollInfo

Referensi

SCROLLINFO