CWnd::GetUpdateRect

發行項
02/28/2013

BOOL GetUpdateRect(
   LPRECT lpRect,
   BOOL bErase = FALSE 
);

參數

lpRect
為接收更新用戶端座標封入更新區域的 CRect 針對或的長度結構的點。

將這個參數設定為 NULL 判斷更新區域是否在 CWnd中是否存在。如果 lpRect 是 NULL， GetUpdateRect 成員函式傳回非零，如果更新區域存在和 0 時，如果沒有。這可讓您判斷 WM_PAINT 訊息是否導致無效區域。請勿將這個參數設定為在 Windows 版本 3.0 的 NULL 和之前。
bErase
指定是否要清除背景中更新區域。

傳回值

指定更新區域的狀況。如果更新區域不是空的，則值為非零值 (Nonzero)，則為 0。

如果 lpRect 參數設定為 NULL，傳回值為非零，如果更新區域存在;則為 0。

備註

如果 CWnd 建立 CS_OWNDC 樣式，並對應模式不是 MM_TEXT， GetUpdateRect 成員函式來在邏輯座標的矩形。否則， GetUpdateRect 將工作區座標的矩形。如果沒有更新區域， GetUpdateRect 設定矩形是空的 (設定任何座標為 0)。

bErase 參數指定 GetUpdateRect 是否應清除更新區域的背景。如果 bErase 是是，並更新區域不是空的，則清除背景。若要清除背景， GetUpdateRect 傳送 WM_ERASEBKGND 資訊。

BeginPaint 成員函式來擷取更新的矩形和 GetUpdateRect 成員函式以取得的一樣。

BeginPaint 成員函式會自動驗證更新區域，因此， GetUpdateRect 對的呼叫所述，在 [ BeginPaint 的呼叫擷取空白更新區域之後。