Bagikan melalui


Fungsi SetScrollRange (winuser.h)

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)

Lihat juga

GetScrollInfo

GetScrollPos

GetScrollRange

Referensi

SetScrollInfo

SetScrollPos

Tampilkan Bilah Daftar