ScrollWindow

ScrollWindow

函數功能該函數滾動所指定的窗口客戶區域內容。函數提供了向後兼容性,新的應用程序應使用ScrollWindowEX返回值:如果函數運行成功,返回值為非零;如果函數運行失敗,返回值為零。應用程序最終最終受到 WM_PAINT的消息,通知它區域必須被重畫。

函數功能


該函數滾動所指定的窗口客戶區域內容。該函數存在向後 兼容性,新的應用程序應使用 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.1Windows 95以上,頭文件:winuser.h;庫文件:user32.lib。

函數信息


最低DLL版本:comctl32.dll
頭文件:在Winuser.h中聲明,調用時需包含Windows.h
導入庫:user32.lib
最低系統版本:Windows 95, Windows NT 3.1及以上版本