setScrollRange 函式 (winuser.h)

發行項
03/04/2024

SetScrollRange 函式會設定指定滾動條的最小和最大滾動盒位置。

注意提供 SetScrollRange 函式以取得回溯相容性。新的應用程式應該使用 SetScrollInfo 函式。

語法

BOOL SetScrollRange(
  [in] HWND hWnd,
  [in] int  nBar,
  [in] int  nMinPos,
  [in] int  nMaxPos,
  [in] BOOL bRedraw
);

參數

[in] hWnd

類型： HWND

根據 nBar 參數的值，處理滾動條控件或具有標準滾動條的視窗。

[in] nBar

類型： int

指定要設定的滾動條。此參數可以是下列其中一個值。

值	意義
SB_CTL	設定滾動條控件的範圍。 hwnd 參數必須是滾動條控件的句柄。
SB_HORZ	設定視窗的標準水準滾動條範圍。
SB_VERT	設定視窗的標準垂直滾動條範圍。

[in] nMinPos

類型： int

指定最小卷動位置。

[in] nMaxPos

類型： int

指定卷動位置上限。

[in] bRedraw

類型： BOOL

指定是否應該重新繪製滾動條以反映變更。如果此參數為 TRUE，則會重新繪製滾動條。如果為 FALSE，則不會重新繪製滾動條。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

您可以使用 SetScrollRange 將 nMinPos 和 nMaxPos 設定為相同的值來隱藏滾動條。應用程式不應該呼叫 SetScrollRange 函式，在處理滾動條訊息時隱藏滾動條。新的應用程式應該使用 ShowScrollBar 函式來隱藏滾動條。

如果對 SetScrollRange 的呼叫緊接在對 SetScrollPos 函式的呼叫之後，SetScrollPos 中的 bRedraw 參數必須是零，以避免繪製滾動條兩次。

標準滾動條的預設範圍是 0 到 100。滾動條控件的預設範圍是空的 (nMinPos 和 nMaxPos 參數值都是零) 。 nMinPos 和 nMaxPos 參數所指定的值之間的差異不得大於 MAXLONG 的值。

由於指出滾動條位置的訊息WM_HSCROLL 和 WM_VSCROLL限制為16位的位置數據，因此只依賴這些位置數據訊息的應用程式，對於 SetScrollRange 函式的 nMaxPos 參數，其實際最大值為65,535。

不過，由於 SetScrollInfo、SetScrollPos、SetScrollRange、GetScrollInfo、GetScrollPos 和 GetScrollRange 函式支援 32 位滾動條位置數據，因此有一種方式可以規避WM_HSCROLL和WM_VSCROLL訊息的 16 位屏障。如需技術的描述，請參閱 GetScrollInfo 。

如果 nBar 參數SB_CTL，而 hWnd 參數指定的視窗不是系統滾動條控制件，則系統會將 SBM_SETRANGE 訊息傳送至視窗以設定滾動條資訊。這可讓 SetScrollRange 在模擬滾動條的自定義控件上運作。如果視窗未處理 SBM_SETRANGE 訊息， SetScrollRange 函式會失敗。

範例

如需範例，請參閱使用 Owner-Display 剪貼簿格式。

規格需求

需求	值
最低支援的用戶端	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)