CWnd::RedrawWindow

BOOL RedrawWindow(
     LPCRECT lpRectUpdate = NULL,
     CRgn* prgnUpdate = NULL,
     UINT flags = RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE
     );

返回值：如果窗口被成功地重画，则返回非零值；否则返回0。

参数：
lpRectUpdate指向一个RECT结构，其中包含了更新区域的坐标。如果prgnUpdate中包含了有效的区域句柄，则这个参数将被忽略。
prgnUpdate表示了更新区域。如果prgnUpdate和lpRectUpdate都为NULL，则整个客户区将被加入更新区域。
flags下面的标志被用于使窗口无效：
RDW_ERASE使窗口在重画时接收到一个WM_ERASEBKGND消息。必须同时指定RDW_INVALIDATE标志；否则RDW_ERASE标志将没有效果。
RDW_FRAME使窗口非客户区中与更新区域重叠的任何部分接收到一条WM_NCPAINT消息。必须同时指定RDW_INVALIDATE标志，否则RDW_FRAME标志将没有效果。
RDW_INTERNALPAINT使一条WM_PAINT消息被传递到窗口，而不管窗口是否包含一个无效区域。
RDW_INVALIDATE使lpRectUpdate或prgnUpdate（仅有一个可能为NULL）无效。如果这个两个参数都为NULL，则整个窗口都无效。

下面的标志被用于使窗口有效：
RDW_NOERASE禁止任何未处理的WM_ERASEBKGND消息。
RDW_NOFRAME禁止任何未处理的WM_NCPAINT消息。这个标志必须与RDW_VALIDATE一起使用，通常也与RDW_NOCHILDREN一起使用。这个选项必须小心使用，因为它可能会使窗口的某些部分不能正确地画出。
RDW_NOINTERNALPAINT禁止任何未处理的内部WM_PAINT消息。这个标志不影响从无效区域产生的WM_PAINT消息。
RDW_VALIDATE使lpRectUpdate或prgnUpdate（仅有一个可能为NULL）有效。如果这个两个参数都为NULL，则整个窗口都有效。这个标志不影响内部WM_PAINT消息。
下面的标志控制着何时产生重画动作。除非指定了这些位，否则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消息。
在缺省情况下，RedrawWindow函数影响的窗口依赖于指定的窗口是否具有WS_CLIPCHILDREN风格。WS_CLIPCHILDREN窗口的子窗口不会被影响。但是，那些不具有WS_CLIPCHILDREN风格的窗口将被递归地有效或无效，直到遇见具有WS_CLIPCHILDREN风格的窗口。下面的标志控制着RedrawWindow函数将影响哪些窗口：
RDW_ALLCHILDREN在重画操作中包含子窗口，如果有的话。
RDW_NOCHILDREN在重画操作中不包括子窗口，如果有的化。

说明：
这个函数更新给定窗口的客户区中指定的矩形或区域。
当RedrawWindow成员函数被用于使捉摸窗口的部分无效的时候，该窗口不接收WM_PAINT消息。如果要重画桌面，应用程序必须使用CWnd::ValidateRgn，CWnd::InvalidateRgn，CWnd::UpdateWindow或::RedrawWindow。