CWnd::ScrollWindowEx

發行項
02/28/2013

移動視窗之用戶端區域的內容。

int ScrollWindowEx(
   int dx,
   int dy,
   LPCRECT lpRectScroll,
   LPCRECT lpRectClip,
   CRgn* prgnUpdate,
   LPRECT lpRectUpdate,
   UINT flags 
);

參數

dx
在單位指定數量，，水平捲動。這個參數必須有負值捲動至左方。
dy
在單位指定數量，，垂直捲動。這個參數必須有移動負值。
lpRectScroll
為的長度結構指定的點會捲動工作區的一部分。如果此參數為， NULL整個工作區移動。
lpRectClip
為 RECT 結構指定的點裁剪矩形移動。這個結構的優先順序高於矩形所指向的 lpRectScroll。在這個矩形內只會移動。在這個矩形以外的位元不會受到影響，即使在 lpRectScroll 矩形。如果此參數為， NULL裁剪捲動矩形不會執行。
prgnUpdate
識別修改存放區域失效捲動區域。這個參數可以是 NULL。
lpRectUpdate
要接收移動失效的矩形界限的 RECT 的點建構。這個參數可以是 NULL。
flags
可以是下列其中一個值:
- SW_ERASE ，指定與 SW_INVALIDATE，清除最近失效的區域會透過傳送 WM_ERASEBKGND 訊息寫入視窗。
- SW_INVALIDATE 失效 prgnUpdate 判斷區域在移動之後。
- SW_SCROLLCHILDREN 移動矩形交集所指向的 lpRectScroll 由 dx 和 dy所指定的像素數目的子視窗。視窗傳送訊息至 WM_MOVE 交集 lpRectScroll的子視窗，，即使不會移動。將插入號重新調整位置，在子視窗移開時，而且游標矩形交集捲動矩形。

傳回值

傳回值是 SIMPLEREGION (矩形失效的區域)， COMPLEXREGION (是矩形失效的區域，重疊的矩形)，或 NULLREGION (沒有失效的區域)，則為，如果函式成功，否則傳回值是錯誤。

備註

這個功能類似於 ScrollWindow 函式，以及其他功能。

如果 SW_INVALIDATE 和 SW_ERASE 未指定， ScrollWindowEx 成員函式不移動失效的區域。如果其中一個旗標設為， ScrollWindowEx 失效的區域。區域之前，不會更新應用程式 UpdateWindow 呼叫成員函式，呼叫 RedrawWindow 成員函式 (指定 RDW_UPDATENOW 或 RDW_ERASENOW)，或從應用程式佇列不會擷取 WM_PAINT 訊息。

如果視窗是 WS_CLIPCHILDREN。樣式， prgnUpdate 和 lpRectUpdate 指定傳回的區域表示必須更新移動視窗的整個頁面，包括在需要更新的子視窗的任何區域。

如果 SW_SCROLLCHILDREN 旗標，指定視窗不會適當地更新畫面，如果一部分的子視窗中移動。在來源矩形之外移動之 MDI 子視窗的組件在其新的目的就無法適當地清除並不會重新繪製。使用 DeferWindowPos Windows 函式移動 lpRectScroll 矩形間不完全的子視窗。游標位置，如果 SW_SCROLLCHILDREN 旗標，並插入號矩形交集捲動矩形。

所有輸入和輸出座標 (適用於 lpRectScroll、 lpRectClip、 lpRectUpdate和 prgnUpdate) 假設在工作區座標中，不論視窗是否具有 CS_OWNDC 或 CS_CLASSDC 類別樣式。使用 LPtoDP 和 DPtoLP Windows 函式進出邏輯座標轉換，如果需要。