Fungsi GetScrollRange (winuser.h)

Artikel
08/27/2023

Fungsi GetScrollRange mengambil posisi kotak gulir minimum dan maksimum (jempol) saat ini untuk bilah gulir yang ditentukan.

Catatan Fungsi GetScrollRange disediakan hanya untuk kompatibilitas. Aplikasi baru harus menggunakan fungsi GetScrollInfo .

Sintaks

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

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 tempat posisi diambil. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
SB_CTL	Mengambil posisi kontrol bilah gulir. Parameter hWnd harus menjadi handel ke kontrol bilah gulir.
SB_HORZ	Mengambil posisi bilah gulir horizontal standar jendela.
SB_VERT	Mengambil posisi bilah gulir vertikal standar jendela.

[out] lpMinPos

Jenis: LPINT

Penunjuk ke variabel bilangan bulat yang menerima posisi minimum.

[out] lpMaxPos

Jenis: LPINT

Penunjuk ke variabel bilangan bulat yang menerima posisi maksimum.

Nilai kembali

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

Jika jendela yang ditentukan tidak memiliki bilah gulir standar atau bukan kontrol bilah gulir, fungsi GetScrollRange menyalin nol ke parameter lpMinPos dan lpMaxPos .

Rentang default untuk bilah gulir standar adalah 0 hingga 100. Rentang default untuk kontrol bilah gulir kosong (kedua nilai adalah nol).

Pesan yang menunjukkan posisi bilah gulir, WM_HSCROLL dan WM_VSCROLL, dibatasi hingga 16 bit data posisi. Namun, karena SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos, dan GetScrollRange mendukung data posisi bilah gulir 32-bit, ada cara untuk menghindari hambatan 16-bit dari pesan WM_HSCROLL dan WM_VSCROLL . Lihat fungsi 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_GETRANGE ke jendela untuk mendapatkan informasi bilah gulir. Ini memungkinkan GetScrollRange beroperasi pada kontrol kustom yang meniru bilah gulir. Jika jendela tidak menangani pesan SBM_GETRANGE , fungsi GetScrollRange gagal.

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