Bagikan melalui


Fungsi GetScrollPos (winuser.h)

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)

Lihat juga

GetScrollInfo

GetScrollRange

Referensi

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL