Fungsi SetScrollRange (winuser.h)

Artikel
08/28/2023

Fungsi SetScrollRange mengatur posisi kotak gulir minimum dan maksimum untuk bilah gulir yang ditentukan.

Catatan Fungsi SetScrollRange disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsi SetScrollInfo .

Sintaks

BOOL SetScrollRange(
  [in] HWND hWnd,
  [in] int  nBar,
  [in] int  nMinPos,
  [in] int  nMaxPos,
  [in] BOOL bRedraw
);

Parameter

[in] hWnd

Jenis: HWND

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

[in] nBar

Jenis: int

Menentukan bilah gulir yang akan disetel. Parameter ini bisa menjadi salah satu nilai berikut.

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

[in] nMinPos

Jenis: int

Menentukan posisi pengguliran minimum.

[in] nMaxPos

Jenis: int

Menentukan posisi pengguliran maksimum.

[in] bRedraw

Jenis: BOOL

Menentukan apakah bilah gulir harus digambar ulang untuk mencerminkan perubahan. Jika parameter ini TRUE, bilah gulir akan digambar ulang. Jika FALSE, bilah gulir tidak digambar ulang.

Mengembalikan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Anda dapat menggunakan SetScrollRange untuk menyembunyikan bilah gulir dengan mengatur nMinPos dan nMaxPos ke nilai yang sama. Aplikasi tidak boleh memanggil fungsi SetScrollRange untuk menyembunyikan bilah gulir saat memproses pesan bilah gulir. Aplikasi baru harus menggunakan fungsi ShowScrollBar untuk menyembunyikan bilah gulir.

Jika panggilan ke SetScrollRange segera mengikuti panggilan ke fungsi SetScrollPos , parameter bRedraw di SetScrollPos harus nol untuk mencegah bilah gulir digambar dua kali.

Rentang default untuk bilah gulir standar adalah 0 hingga 100. Rentang default untuk kontrol bilah gulir kosong (nilai parameter nMinPos dan nMaxPos adalah nol). Perbedaan antara nilai yang ditentukan oleh parameter nMinPos dan nMaxPos tidak boleh lebih besar dari nilai MAXLONG.

Karena pesan yang menunjukkan posisi bilah gulir, WM_HSCROLL dan WM_VSCROLL, dibatasi hingga 16 bit data posisi, aplikasi yang hanya bergantung pada pesan tersebut untuk data posisi memiliki nilai maksimum praktis 65.535 untuk parameter nMaxPos fungsi SetScrollRange.

Namun, karena fungsi SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos, dan GetScrollRange mendukung data posisi bilah gulir 32-bit, ada cara untuk menghindari hambatan 16-bit pesan WM_HSCROLL dan WM_VSCROLL . Lihat GetScrollInfo untuk deskripsi teknik.

Jika parameter nBar SB_CTL dan jendela yang ditentukan oleh parameter hWnd bukan kontrol bilah gulir sistem, sistem mengirim pesan SBM_SETRANGE ke jendela untuk mengatur informasi bilah gulir. Ini memungkinkan SetScrollRange untuk beroperasi pada kontrol kustom yang meniru bilah gulir. Jika jendela tidak menangani pesan SBM_SETRANGE , fungsi SetScrollRange gagal.

Contoh

Misalnya, lihat Menggunakan Format Clipboard Owner-Display.

Persyaratan

Persyaratan	Nilai
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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-2-0 (diperkenalkan dalam Windows 8.1)