勇芳软件工作室.汉化:  Painting and Drawing > Painting and Drawing Functions >

GetUpdateRect

Previous pageReturn to chapter overviewNext page

描述

 

GetUpdateRect函数检索完全包围指定窗口的更新区域的最小矩形的坐标。GetUpdateRect以逻辑坐标检索矩形。如果没有更新区域,GetUpdateRect检索一个空矩形(将所有坐标设置为零)。

 

C++ 语法

 

BOOL GetUpdateRect(

__in  HWND hWnd,

__out LPRECT lpRect,

__in  BOOL bErase

);

 

PowerBASIC 语法

 

FUNCTION GetUpdateRect ( _

BYVAL hWnd AS DWORD, _

BYREF lpRect AS RECT, _

BYVAL bErase AS LONG _

) AS LONG

 

参数

 

hWnd

 

[in]处理要更新更新区域的窗口。

 

lpRect

 

[out]指向RECT结构的指针,它以包含矩形的设备为单位接收坐标。

 

应用程序可以将此参数设置为NULL,以确定窗口是否存在更新区域。如果此参数为NULL,则GetUpdateRect如果存在更新区域,则返回非零值,如果不存在则返回0。这提供了确定WM_PAINT消息是否由无效区域产生的简单有效的手段。

 

bErase

 

[in]指定是否删除更新区域中的背景。如果此参数为TRUE并且更新区域不为空,则GetUpdateRect将向指定的窗口发送WM_ERASEBKGND消息以擦除背景。

 

返回值

 

如果更新区域不为空,返回值不为零。

 

如果没有更新区域,返回值为零。

 

备注

 

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

 

BeginPaint会自动验证更新区域,所以在致电BeginPaint之后立即调用GetUpdateRect调用一个空的更新区域。

 

引用文件 #INCLUDE Once

 

WinUser.inc(包括Windows.inc)