共用方式為


getScrollRange 函式 (winuser.h)

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 函式會將零複製到 lpMinPoslpMaxPos 參數。

標準捲軸的預設範圍是 0 到 100。 捲軸控制項的預設範圍是空的, (兩個值都是零) 。

指出捲軸位置 WM_HSCROLLWM_VSCROLL的訊息限制為 16 位的位置資料。 不過,由於SetScrollInfoSetScrollPosSetScrollRangeGetScrollInfo、GetScrollPosGetScrollRange支援 32 位捲軸位置資料,因此有辦法規避WM_HSCROLLWM_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

另請參閱

GetScrollInfo

GetScrollPos

參考

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL