getScrollRange 函式 (winuser.h)

發行項
03/15/2023

GetScrollRange函式會擷取目前最小和最大捲動方塊， (指) 指定捲軸的位置。

注意GetScrollRange函式僅供相容性使用。新的應用程式應該使用 GetScrollInfo 函式。

語法

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

參數

[in] hWnd

類型： HWND

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

[in] nBar

類型： int

指定從中擷取位置的捲軸。此參數可以是下列其中一個值。

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

[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