SetScrollRange函式設定所指定滾動條範圍的最小值和最大值。
基本介紹
- 中文名：SetScrollRange
- 功能：指定滾動條範圍的最小值和最大值
- 原型：BOOL SetScrollRange
- 參數：hWnd
函式功能,函式原型,參數,返回值,備註,速查,
函式功能
SetScrollRange函式設定所指定滾動條範圍的最小值和最大值。
注意 SetScrollRange函式提供向後的兼容性。新的應用程式應該使用SetScrollInfo函式
函式原型
BOOL SetScrollRange(
HWND hWnd, // 視窗句柄
int nBar, // 滾動條類型
int nMinPos, // 滾動條的最小位置
int nMaxPos, // 滾動條的最大位置
BOOL bRedraw // 重繪標誌
);
參數
hWnd
[輸入] 滾動條控制項或帶有標準滾動條窗體的句柄，由nBar參數值確定。
nBar
[輸入] 指定滾動條將被設定。這個參數可以是下表值中的一個，含義如下：
值 | 說明 |
SB_CTL | 設定滾動條控制項的範圍。而參數hwnd必須是滾動條控制項的句柄。 |
SB_HORZ | 設定窗體的標準水平滾動條的範圍。 |
SB_VERT | 設定窗體的標準垂直滾動條的範圍 |
nMinPos
[輸入] 指定滾動位置的最小值。
nMaxPos
[輸入] 指定滾動位置的最大值.。
bRedraw
[輸入] 指定滾動條是否被重畫以反映變化。如果這個參數為TRUE，滾動條將被重畫；如果為FALSE則不被重畫。
返回值
如果函式運行成功，返回值為非零；
如果函式運行失敗，返回值為零。
若想獲得更多的錯誤信息，請調用GetLastError函式。
備註
可以將SetScrollRange中的nMinPos和nMaxPos參數設定為一樣的值來使用，達到隱藏滾動條的目的。但在處理滾動條訊息時，應用程式不應該調用函式SetScrollRange來隱藏滾動條。新的應用程式使用函式ShowScrollBar來隱藏滾動條。
如果調用函式SetScrollPos之後馬上調用函式SetScrollRange，則SetScrollPos中的bRedraw參數一定要設定為零值(FALSE)，以防止滾動條被畫兩次。
標準滾動條的預設範圍是0到100。滾動條控制項的預設值為NULL（參數nMinPos和nMaxPos的值均為零）。兩個範圍值之間的不同之處在於由參數nMinPos和nMaxPos指定的值不能超過MAXLONG的值。
因為說明滾動條位置的訊息WM_HSCROLL和 WM_VSCROLL只能為16位數據，那些只依賴於說明位置數據訊息的應用程式在函式SetScrollRange的參數nMaxPos中有一個實際最大值65,535 。但是，因為函式SetScrolllnfo，SetScrollPos， SetScrollRange，GetScrolllnfo，GetScrollPos，和GetScrollRange都支持32位的滾動條位置數據，所以有一個解決16位WM_HSCROLL和WM_VSCROLL訊息阻礙的途徑，請參見函式GetScrolllnfo的有關技術說明。
如果參數 nBar 設定為 SB_CTL 並且參數hWnd 所標識的不是一個標準的滾動條控制項。系統將傳送一個SBM_SETRANGE 訊息到窗體用以設定滾動條訊息。 這將允許函式SetScrollRange 操作一個定製的偽滾動條控制項。如果窗體沒有處理 SBM_SETRANGE訊息,函式SetScrollRange將失敗.
速查
Windows NT 3.1、Windows CE 2.0以上，頭檔案：winuser.h；庫檔案：user32.lib。
