Share via

GetScrollBarInfo 函式 (winuser.h)

  • 發行項

GetScrollBarInfo 函式會擷取指定滾動條的相關信息。

語法

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

參數

[in] hwnd

類型： HWND

處理與要擷取其資訊之滾動條相關聯的視窗。 如果 idObject 參數 OBJID_CLIENT，hwnd 是滾動條控件的句柄。 否則， hwnd 是使用 WS_VSCROLL 和/或 WS_HSCROLL 樣式所建立之視窗的句柄。

[in] idObject

類型： LONG

指定滾動條物件。 此參數可以是下列其中一個值。

值 意義
OBJID_CLIENT
 hwnd 參數是滾動條控件的句柄。
OBJID_HSCROLL
 hwnd 視窗的水平滾動條。
OBJID_VSCROLL
 hwnd 視窗的垂直滾動條。

[out] psbi

類型： PSCROLLBARINFO

要接收資訊的 SCROLLBARINFO 結構的指標。 呼叫 GetScrollBarInfo 之前，請將 cbSize 成員設定為 sizeof (SCROLLBARINFO) 。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果 idObject 是OBJID_CLIENT且 hwnd 指定的視窗不是系統滾動條控件，則系統會將 SBM_GETSCROLLBARINFO 訊息傳送至視窗以取得滾動條資訊。 這可讓 GetScrollBarInfo 在模擬滾動條的自定義控件上操作。 如果視窗未處理 SBM_GETSCROLLBARINFO 訊息， GetScrollBarInfo 函式會失敗。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
可轉散發套件 Service Pack 6
API 集合 ext-ms-win-ntuser-misc-l1-2-0 (於 Windows 8.1)

另請參閱

SCROLLBARINFO