複製鏈接
請複製以下鏈接發送給好友

ScrollWindow

鎖定
ScrollWindow是計算機編程中的一種函數類型,該函數滾動所指定的窗口客户區域內容。如果函數運行成功,返回值為非零;如果函數運行失敗,返回值為零。
外文名
ScrollWindow
最低系統版本
Windows 95, Windows NT 3.1及以上版本

ScrollWindow函數功能

該函數存在向後兼容性,新的應用程序應使用ScrollWindowEX

ScrollWindow函數原型

BOOL ScrollWindow(HWND hWnd, int XAmount, int YAmount, CONST RECT *IpRect, CONST RECT *lpClipRect);

ScrollWindow參數

hWnd
[in]客户區域將被滾動的窗口的句柄
XAmount
[in]指定水平滾動的距離,以設備單位計。如果窗口類風格為CS_OWNDC或CS_CLASSDC,則此參數則使用邏輯單位而非設備單位。當向左滾動窗體內容時,參數值必須為負。
YAmount
[in]指定垂直滾動的距離,以設備單位計。如果窗口類風格為CS_OWNDC或CS_CLASSDC,則此參數則使用邏輯單位而非設備單位。當向上滾動窗體內容時,參數值必須為負。
lpRect
[in]指向RECT結構的指針,該結構指定了將要滾動的客户區範圍。若此參數為NULL,則整個客户區域將被滾動。
lpClipRect
[in]指向RECT結構的指針,該結構指定了要滾動的裁剪區域。只有這個矩形中的位才會被滾動。在矩形之外的位不會被影響,即使它們是在lpRect矩形之內。(見代碼"測試一")假如lpClipRect為NULL,則不會在滾動矩形上進行裁剪。

ScrollWindow返回值

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

ScrollWindow注意

如果在被滾動的窗口中含有插入符,ScrollWindow將自動隱藏插入符,以防它被擦掉;當滾動結束後再恢復插入符。插入符的位置相應的被調整過來。
未被ScrollWindow覆蓋的區域不再重畫,但該區域會與窗口更新區域組合。應用程序最終收到WM_PAINT的消息,通知它結合區域必須被重畫。為了在滾動操作的同時重畫未覆蓋區域,則應在調用ScrollWindow函數後馬上調用UpdateWindow函數。
如果參數lpRect為NULL,則窗口中的任何子窗口的位置由參數XAmount和Yamount的數值決定偏移;窗體無效(未着色)的區域也偏移。IpRect為NULL時ScrollWindow執行地更快。
如果參數lpRect不為NULL,則窗口中的子窗口的位置不改變,窗口中無效(未着色)的區域也不偏移。為了防止lpRect不為NULL時更新的問題,需要在調用ScrollWindow前調用UpdateWindow函數重繪窗口。

ScrollWindow函數信息

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