GetUpdateRect

【勇芳软件工作室】汉化HomePreviousNext

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