Bagikan melalui


Fungsi GetScrollRange (winuser.h)

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

Lihat juga

GetScrollInfo

GetScrollPos

Referensi

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL