共用方式為


GetScrollPos 函式 (winuser.h)

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_HSCROLLWM_VSCROLL,但限制為 16 位的位置資料,但SetScrollPosSetScrollRangeGetScrollPos 和 GetScrollRange函式支援 32 位捲軸位置資料。 因此,應用程式可以在處理WM_HSCROLLWM_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)

另請參閱

GetScrollInfo

GetScrollRange

參考

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL