Fungsi GetScrollPos (winuser.h)

Artikel
08/27/2023

Fungsi GetScrollPos mengambil posisi kotak gulir (jempol) saat ini di bilah gulir yang ditentukan. Posisi saat ini adalah nilai relatif yang bergantung pada rentang gulir saat ini. Misalnya, jika rentang gulir adalah 0 hingga 100 dan kotak gulir berada di tengah bilah, posisi saat ini adalah 50.

Catatan Fungsi GetScrollPos disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsi GetScrollInfo .

Sintaks

int GetScrollPos(
  [in] HWND hWnd,
  [in] int  nBar
);

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

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

Nilai kembali

Jenis: int

Jika fungsi berhasil, nilai yang dikembalikan adalah posisi kotak gulir saat ini.

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

Keterangan

Fungsi GetScrollPos memungkinkan aplikasi menggunakan posisi gulir 32-bit. Meskipun pesan yang menunjukkan posisi bilah gulir, WM_HSCROLL dan WM_VSCROLL, dibatasi hingga 16 bit data posisi, fungsi SetScrollPos, SetScrollRange, GetScrollPos, dan GetScrollRange mendukung data posisi bilah gulir 32-bit. Dengan demikian, aplikasi dapat memanggil GetScrollPos saat memproses pesan WM_HSCROLL atau WM_VSCROLL untuk mendapatkan data posisi bilah gulir 32-bit.

Untuk mendapatkan posisi 32-bit kotak gulir (jempol) selama kode permintaan SB_THUMBTRACK dalam pesan WM_HSCROLL atau WM_VSCROLL , gunakan fungsi GetScrollInfo .

Jika parameter nBar SB_CTL dan jendela yang ditentukan oleh parameter hWnd bukan kontrol bilah gulir sistem, sistem mengirim pesan SBM_GETPOS ke jendela untuk mendapatkan informasi bilah gulir. Ini memungkinkan GetScrollPos beroperasi pada kontrol kustom yang meniru bilah gulir. Jika jendela tidak menangani pesan SBM_GETPOS , fungsi GetScrollPos 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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-2-0 (diperkenalkan di Windows 8.1)