Bagikan melalui


Fungsi GetScrollBarInfo (winuser.h)

Fungsi GetScrollBarInfo mengambil informasi tentang bilah gulir yang ditentukan.

Sintaks

BOOL GetScrollBarInfo(
  [in]  HWND           hwnd,
  [in]  LONG           idObject,
  [out] PSCROLLBARINFO psbi
);

Parameter

[in] hwnd

Jenis: HWND

Tangani ke jendela yang terkait dengan bilah gulir yang informasinya akan diambil. Jika parameter idObject OBJID_CLIENT, hwnd adalah handel ke kontrol bilah gulir. Jika tidak, hwnd adalah handel ke jendela yang dibuat dengan gaya WS_VSCROLL dan/atau WS_HSCROLL .

[in] idObject

Jenis: LONG

Menentukan objek bilah gulir. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
OBJID_CLIENT
Parameter hwnd adalah handel ke kontrol bilah gulir.
OBJID_HSCROLL
Bilah gulir horizontal dari jendela hwnd .
OBJID_VSCROLL
Bilah gulir vertikal jendela hwnd .

[out] psbi

Jenis: PSCROLLBARINFO

Arahkan ke struktur SCROLLBARINFO untuk menerima informasi. Sebelum memanggil GetScrollBarInfo, atur anggota cbSize ke sizeof(SCROLLBARINFO).

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

Jika idObject OBJID_CLIENT dan jendela yang ditentukan oleh hwnd bukan kontrol bilah gulir sistem, sistem mengirim pesan SBM_GETSCROLLBARINFO ke jendela untuk mendapatkan informasi bilah gulir. Ini memungkinkan GetScrollBarInfo beroperasi pada kontrol kustom yang meniru bilah gulir. Jika jendela tidak menangani pesan SBM_GETSCROLLBARINFO , fungsi GetScrollBarInfo gagal.

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
Redistribusi Paket Layanan 6
Set API ext-ms-win-ntuser-misc-l1-2-0 (diperkenalkan dalam Windows 8.1)

Lihat juga

SCROLLBARINFO