RedrawWindow

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

RedrawWindow 函数用于更新窗口客户区指定的矩形或区域。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL RedrawWindow(
  _In_       HWND hWnd,
  _In_ const RECT *lprcUpdate,
  _In_       HRGN hrgnUpdate,
  _In_       UINT flags
);

参数解析：

参数	含义
hWnd	1. 指向将被重绘的窗口的句柄 2. 如果该参数为 NULL，则更新桌面窗口
lprcUpdate	1. 指向 RECT 结构的指针，该结构包含更新矩形在设备单位上的坐标 2. 如果 hrgnUpdate 参数标志一个区域，则该参数将被忽略
hrgnUpdate	1. 指向更新区域的指针 2. 如果 hrgnUpdate 和 lprcUpdate 参数都为 NULL，则整个客户区将被添加到更新区域
flags	1. 一个或多个重绘标识 2. 该参数可以使窗口变得无效或者有效，控制重绘，以及控制 RedrawWindow 函数影响的窗口 3. 下列的标识用来使窗口无效： 标识（无效） 描述 RDW_ERASE 使得当窗口被重绘时，窗口接受一条 WM_ERASEBKGND 消息。RDW_INVALIDATE 标识必须同时被指定，否则 RDW_ERASE 无效 RDW_FRAME 使得任何与更新区域相交的非客户区域接受一条 WM_NCPAINT 消息。RDW_INVALIDATE 标识必须同时被指定，否则 RDW_FRAME 无效。WM_NCPAINT 消息通常在 RedrawWindow 函数的执行过程中不会被发送，除非指定了 RDW_UPDATENOW 或 RDW_ERASENOW RDW_INTERNALPAINT 使得一条 WM_PAINT 消息被传递给窗口而不管窗口的任何部分是否有效 RDW_INVALIDATE 使 lprcUpdate 或 hrgnUpdate 参数无效（只有一个可能为非空）。如果都为 NULL，则整个窗口将无效 4. 下列标识用来使窗口有效： 标识（有效） 含义 RDW_NOERASE 取消所有挂起的 WM_ERASEBKGND 消息 RDW_NOFRAME 取消所有挂起的 WM_NCPAINT 消息。该标识必须与 RDW_VALIDATE 同时使用，并且通常与 RDW_NOCHILDREN 一同使用。应该小心使用 RDW_NOFRAME，因为它可能造成重绘的窗口部分区域绘制不正确 RDW_NOINTERNALPAINT 取消所有挂起的内部 WM_PAINT 消息。该标识不会影响从一个非空更新区域产生的 WM_PAINT 消息 RDW_VALIDATE 使 lprcUpdate 或 hrgnUpdate 有效（只有一个可能为非空）。如果都为 NULL，则整个窗口将有效。该标识不会影响内部 WM_PAINT 消息 5. 下列标识控制何时重绘。RedrawWindow 将不会重绘除非指定了这些标识中的某一个： 标识 含义 RDW_ERASENOW 如果有必要，在函数返回之前，会使受影响的窗口（通过 RDW_ALLCHILDREN 和 RDW_NOCHILDREN 标识指定）接收 WM_NCPAINT 和 WM_ERASEBKGND 消息。WM_PAINT 消息会在平常的时间被接受 RDW_UPDATENOW 如果有必要，在函数返回之前，会使受影响的窗口（通过 RDW_ALLCHILDREN 和 RDW_NOCHILDREN 标识指定）接收 WM_NCPAINT，WM_ERASEBKGND 和 WM_PAINT 消息 6. 默认情况下，RedrawWindow 函数影响的窗口取决于是否指定的窗口含有 WS_CLIPCHILDREN 风格。不含有 WS_CLIPCHILDREN 风格的子窗口不会被影响；非 WS_CLIPCHILDREN 窗口将递归的有效或者无效直到出现一个WS_CLIPCHILDREN 窗口。下列的标识控制 RedrawWindow 函数影响的窗口： 标识 描述 RDW_ALLCHILDREN 如果存在子窗口，重绘操作包括子窗口 RDW_NOCHILDREN 如果存在子窗口，重绘操作排除子窗口

返回值：

1. 如果窗口在此前已被禁用，则返回值为非 0；

2. 如果窗口在此前没有被禁用，则返回值为 0。


备注：

当 RedrawWindow 函数用来使桌面窗口的一部分无效，则桌面窗口不会接收 WM_PAINT 消息。应用程序可以使用 RDW_ERASE 标识来产生一条 WM_ERASEBKGND 消息来重绘桌面。


需求：

Minimum supported client	Windows 2000 专业版[桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [桌面应用程序]
Header	Winuser.h（包含于 Windows.h）
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。