GetScrollPos 函式 (winuser.h)
GetScrollPos函式會擷取指定捲軸中捲動方塊的目前位置 (指) 。 目前位置是相依于目前捲動範圍的相對值。 例如，如果捲動範圍是 0 到 100，而捲動方塊位於列中間，則目前的位置為 50。
注意提供 GetScrollPos函式以進行回溯相容性。 新的應用程式應該使用 GetScrollInfo 函式。
語法
int GetScrollPos(
[in] HWND hWnd,
[in] int nBar
);
參數
[in] hWnd
類型： HWND
根據 nBar 參數的值，處理捲軸控制項或具有標準捲軸的視窗。
[in] nBar
類型： int
指定要檢查的捲軸。 此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
擷取捲軸控制項中捲動方塊的位置。 hWnd參數必須是捲軸控制項的控制碼。 |
|
擷取視窗標準水準捲軸中捲動方塊的位置。 |
|
擷取視窗標準垂直捲動條中捲動方塊的位置。 |
傳回值
類型： 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) |
另請參閱
參考