SetScrollRange

SetScrollRange函式設定所指定滾動條範圍的最小值和最大值。 SetScrollRange函式提供向後的兼容性。

功能原理

函式功能:該函式設定所指定滾動條位置的最大最小值。
函式原型: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參數一定為零,以防止滾動條被畫兩次。
標準滾動條的預設範圍時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的有關技術說明。
速查:Windows NT 3.1、Windows CE 2.0以上,頭檔案:winuser.h;庫檔案:user32.lib。

相關詞條

相關搜尋

熱門詞條

聯絡我們