CWnd::GetUpdateRect

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

参数

  • lpRect
    指向 CRect 是接收更新工作区坐标将更新区域的对象或 RECT 结构。

    将此参数设置为 NULL 确定更新区域是否在 CWnd内存。 如果 lpRect 是 NULLGetUpdateRect 成员函数返回非零值,如果更新区域显示和0,如果一个不。 这提供了一种确定 WM_PAINT 消息是否产生无效的区域。 不要将此参数设置为在Windows 3.0版的 NULL 和之前。

  • bErase
    指定是否将清除后台在更新区域。

返回值

指定更新区域的状态。 如果更新区域不为空,该值不为零;否则为0。

如果 lpRect 参数设置为 NULL,则返回值是非零,如果更新区域存在;否则为0。

备注

如果 CWndCS_OWNDC 样式创建的,并且该映射的方案是 MM_TEXTGetUpdateRect 成员函数以逻辑坐标的矩形。 否则,GetUpdateRect 对工作区坐标的矩形。 如果未更新区域,GetUpdateRect 设置矩形为空(将所有坐标到0)。

bErase 参数指定 GetUpdateRect 是否应该清除更新区域的背景。 如果 bErase 是 TRUE,并更新区域不为空,清除背景。 若要清除后台,GetUpdateRect 发送 WM_ERASEBKGND 信息。

BeginPaint 成员函数检索的更新矩形与 GetUpdateRect 成员函数检索的相同。

BeginPaint 成员函数自动验证更新区域,因此,任何调用 GetUpdateRect 提交,在对 BeginPaint 的调用来检索一个空更新区域之后。

要求

Header: afxwin.h

请参见

参考

CWnd 类

层次结构图

CWnd::BeginPaint

GetUpdateRect

CWnd::OnPaint

CWnd::RedrawWindow