getScrollRange 函式 (winuser.h)
GetScrollRange函式會擷取目前最小和最大捲動方塊， (指) 指定捲軸的位置。
語法
BOOL GetScrollRange(
[in] HWND hWnd,
[in] int nBar,
[out] LPINT lpMinPos,
[out] LPINT lpMaxPos
);
參數
[in] hWnd
類型： HWND
根據 nBar 參數的值，處理捲軸控制項或具有標準捲軸的視窗。
[in] nBar
類型： int
指定從中擷取位置的捲軸。 此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
擷取捲軸控制項的位置。 hWnd參數必須是捲軸控制項的控制碼。 |
|
擷取視窗標準水準捲軸的位置。 |
|
擷取視窗標準垂直捲動條的位置。 |
[out] lpMinPos
類型： LPINT
接收最小位置之整數變數的指標。
[out] lpMaxPos
類型： LPINT
接收最大位置之整數變數的指標。
傳回值
類型： BOOL
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
如果指定的視窗沒有標準捲軸或不是捲軸控制項， GetScrollRange 函式會將零複製到 lpMinPos 和 lpMaxPos 參數。
標準捲軸的預設範圍是 0 到 100。 捲軸控制項的預設範圍是空的， (兩個值都是零) 。
指出捲軸位置 WM_HSCROLL 和 WM_VSCROLL的訊息限制為 16 位的位置資料。 不過，由於SetScrollInfo、SetScrollPos、SetScrollRange、GetScrollInfo、GetScrollPos和GetScrollRange支援 32 位捲軸位置資料，因此有辦法規避WM_HSCROLL和WM_VSCROLL訊息的 16 位屏障。 如需技術的描述，請參閱 GetScrollInfo 函式。
如果 nBar 參數SB_CTL，且 hWnd 參數指定的視窗不是系統捲軸控制項，則系統會將 SBM_GETRANGE 訊息傳送至視窗以取得捲軸資訊。 這可讓 GetScrollRange 在模擬捲軸的自訂控制項上運作。 如果視窗未處理 SBM_GETRANGE 訊息， GetScrollRange 函式會失敗。
規格需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
另請參閱
參考