ScrollWindow

函式功能該函式滾動所指定的視窗客戶區域內容。函式提供了向後兼容性,新的應用程式應使用ScrollWindowEX。 返回值:如果函式運行成功,返回值為非零;如果函式運行失敗,返回值為零。應用程式最終最終受到 WM_PAINT的訊息,通知它區域必須被重畫。 如果參數lpRect為空,則窗體中的任何子窗體的位置由參數XAmount和Yamount種的數量決定偏移;窗體無效(未著色)的區域也進行偏移。為了防止lpRect不為空時更新的問題,則在調用ScrollWindow之前先調用UpdateWindow函式重窗體。

函式功能

該函式滾動所指定的視窗客戶區域內容。該函式存在向後 兼容性,新的應用程式應使用 ScrollWindowEX。

概述

函式原型:BOOL ScrollWindow(HWND hWnd,int XAmount,int YAmount,CONST RECT *IpRect, CONST RECT *lpClipRect);

hWnd:客戶區域將被滾動的窗體句柄。

XAmount:指定水平滾動以設備為單位的數量。如果窗體被滾動模式為CS_OWNDC或CS_CLASSDC,此參數則使用邏輯單位而不使用設備單位。當向左滾動窗體內容時,參數值必須為負。

YAmount:指定垂直滾動設備單位數量。如果窗體被滾動模式為CS_OWNDC或CS_CLASSDC,此參數則使用邏輯單位而不使用設備單位。當向上滾動窗體內容時,參數值必須為負。

lpRect:指向所指定將被滾動的客戶區域部分的RECT結構。若此參數為NULL,則整個客戶區域均被滾動。

lpClipRect:指向包含類似於剪輯滾動條RECT結構。只有剪輯矩形條內部的位受影響。由外向內的滾動矩形內部被著色,而由矩形內向外的滾動將不被著色。

返回值:如果函式運行成功,返回值為非零;如果函式運行失敗,返回值為零。若想獲得更多的錯誤信息,請調用GetLastError函式。

注意

如果在被滾動的窗體中由^符,滾動富體將自動隱藏起^符,以防止它被擦掉;當滾動結束後再恢復^符。^符的位置因而被調整過來。

未被ScrollWindow復蓋的區域不再被重畫,但它組合成窗體的更新區域。應用程式最終最終受到 WM_PAINT的訊息,通知它區域必須被重畫。為了在滾動過程的同時重畫未復蓋區域,則應在調用ScrollWindow函式後馬上調用UpdateWindow函式。

如果參數lpRect為空,則窗體中的任何子窗體的位置由參數XAmount和Yamount種的數量決定偏移;窗體無效(未著色)的區域也進行偏移。IpRect為空時ScrollWindow則更快。

如果參數lpRect不為空,則窗體中的子窗體的位置不改變,窗體中無效(未著色)的區域也不進行偏移。為了防止lpRect不為空時更新的問題,則在調用ScrollWindow之前先調用UpdateWindow函式重窗體。

速查:Windows NT 3.1、Windows 95以上,頭檔案:winuser.h;庫檔案:user32.lib。

函式信息

最低DLL版本:comctl32.dll

頭檔案:在Winuser.h中聲明,調用時需包含Windows.h

導入庫:user32.lib

最低系統版本:Windows 95, Windows NT 3.1及以上版本

相關詞條

相關搜尋

熱門詞條

聯絡我們