ScrollWindow

函式功能

該函式存在向後兼容性，新的應用程式應使用ScrollWindowEX。

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

hWnd

[in]客戶區域將被滾動的視窗的句柄。

XAmount

[in]指定水平滾動的距離，以設備單位計。如果視窗類風格為CS_OWNDC或CS_CLASSDC，則此參數則使用邏輯單位而非設備單位。當向左滾動窗體內容時，參數值必須為負。

YAmount

[in]指定垂直滾動的距離，以設備單位計。如果視窗類風格為CS_OWNDC或CS_CLASSDC，則此參數則使用邏輯單位而非設備單位。當向上滾動窗體內容時，參數值必須為負。

lpRect

[in]指向RECT結構的指針，該結構指定了將要滾動的客戶區範圍。若此參數為NULL，則整個客戶區域將被滾動。

lpClipRect

[in]指向RECT結構的指針，該結構指定了要滾動的裁剪區域。只有這個矩形中的位才會被滾動。在矩形之外的位不會被影響，即使它們是在lpRect矩形之內。(見代碼"測試一")假如lpClipRect為NULL，則不會在滾動矩形上進行裁剪。

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

如果在被滾動的視窗中含有插入符，ScrollWindow將自動隱藏插入符，以防它被擦掉；當滾動結束後再恢復插入符。插入符的位置相應的被調整過來。

未被ScrollWindow覆蓋的區域不再重畫，但該區域會與視窗更新區域組合。應用程式最終收到WM_PAINT的訊息，通知它結合區域必須被重畫。為了在滾動操作的同時重畫未覆蓋區域，則應在調用ScrollWindow函式後馬上調用UpdateWindow函式。

如果參數lpRect為NULL，則視窗中的任何子視窗的位置由參數XAmount和Yamount的數值決定偏移；窗體無效（未著色）的區域也偏移。IpRect為NULL時ScrollWindow執行地更快。

如果參數lpRect不為NULL，則視窗中的子視窗的位置不改變，視窗中無效（未著色）的區域也不偏移。為了防止lpRect不為NULL時更新的問題，需要在調用ScrollWindow前調用UpdateWindow函式重繪視窗。

最低DLL版本：comctl32.dll

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