GetScrollPos 函式 (winuser.h)

發行項
08/27/2023

GetScrollPos函式會擷取指定捲軸中捲動方塊的目前位置 (指) 。目前位置是相依于目前捲動範圍的相對值。例如，如果捲動範圍是 0 到 100，而捲動方塊位於列中間，則目前的位置為 50。

注意提供 GetScrollPos函式以進行回溯相容性。新的應用程式應該使用 GetScrollInfo 函式。

語法

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

參數

[in] hWnd

類型： HWND

根據 nBar 參數的值，處理捲軸控制項或具有標準捲軸的視窗。

[in] nBar

類型： int

指定要檢查的捲軸。此參數可以是下列其中一個值。

值	意義
SB_CTL	擷取捲軸控制項中捲動方塊的位置。 hWnd參數必須是捲軸控制項的控制碼。
SB_HORZ	擷取視窗標準水準捲軸中捲動方塊的位置。
SB_VERT	擷取視窗標準垂直捲動條中捲動方塊的位置。

傳回值

類型： int

如果函式成功，則傳回值是捲動方塊的目前位置。

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

備註

GetScrollPos函式可讓應用程式使用 32 位捲動位置。雖然指出捲軸位置的訊息WM_HSCROLL和WM_VSCROLL，但限制為 16 位的位置資料，但SetScrollPos、SetScrollRange、GetScrollPos 和 GetScrollRange函式支援 32 位捲軸位置資料。因此，應用程式可以在處理WM_HSCROLL或WM_VSCROLL訊息時呼叫GetScrollPos，以取得 32 位捲軸位置資料。

若要在WM_HSCROLL或 WM_VSCROLL訊息的SB_THUMBTRACK要求程式碼期間，取得捲動方塊 () 的 32 位位置，請使用GetScrollInfo函式。

如果 nBar 參數SB_CTL且 hWnd 參數指定的視窗不是系統捲軸控制項，則系統會將 SBM_GETPOS 訊息傳送至視窗以取得捲軸資訊。這可讓 GetScrollPos 在模擬捲軸的自訂控制項上運作。如果視窗未處理 SBM_GETPOS 訊息， GetScrollPos 函式會失敗。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-misc-l1-2-0 (于 Windows 8.1)