GetUpdateRect函数检索完全包围指定窗口的更新区域的最小矩形的坐标。如果使用CS_OWNDC样式创建窗口,并且映射模式不是MM_TEXT,则GetUpdateRect将以逻辑坐标检索矩形。否则,它将检索客户端坐标中的矩形。如果没有更新区域,GetUpdateRect将检索一个空矩形(将所有坐标设置为零)。
BOOL GetUpdateRect(
HWND【的hWnd】, | //窗口的句柄 |
LPRECT 【LPRECT】, | //更新矩形坐标的地址 |
BOOL 【// erase-background flag】 | //擦除标志 |
); |
参数
【的hWnd】
标识具有要检索的更新区域的窗口。
【LPRECT】
指向接收包围矩形坐标的RECT结构。
应用程序可以将此参数设置为NULL,以确定窗口是否存在更新区域。如果此参数为NULL,则GetUpdateRect如果更新区域存在则返回非零值,如果不存在则返回0。这提供了一种确定WM_PAINT消息是否由无效区域产生的简单有效的手段。
【// erase-background flag】
指定更新区域中的背景是否被删除。如果此参数为TRUE并且更新区域不为空,则GetUpdateRect向指定的窗口发送WM_ERASEBKGND消息以擦除背景。
返回值
如果更新区域不为空,返回值不为零。
如果没有更新区域,返回值为零。
备注
由BeginPaint函数检索的更新矩形与GetUpdateRect检索到的更新矩形相同。
BeginPaint会自动验证更新区域,因此在致电BeginPaint之后立即调用GetUpdateRect将调用空的更新区域。
也可以看看
BeginPaint, GetUpdateRgn, InvalidateRect, RECT, UpdateWindow, ValidateRect