Fungsi SetScrollInfo (winuser.h)

Artikel
08/28/2023

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

Share via