InvalidateRgn

小甲鱼

函数功能：

InvalidateRgn 函数通过添加一个区域到一个窗口的更新区域中，使得指定区域的客户区变为无效。这个无效区域和所有更新区域中的其他区域将被标记，在下一个 WM_PAINT 消息被触发的时候进行统一绘制。


API 函数原型：

1. BOOL InvalidateRgn(
   
2.   _In_ HWND hWnd,
   
3.   _In_ HRGN hRgn,
   
4.   _In_ BOOL bErase
   
5. );

复制代码

参数解析：

参数	含义
hWnd	指定待更新的客户区所在的窗体的句柄
hRgn	1. 指定待加入更新区域的区域的句柄 2. 该区域被假定使用客户区坐标 3. 如果该参数的值为 NULL，则表示整个客户区将被添加到更新区域
bErase	1. 指定更新区域内的背景是否重绘 2. 如果为 TRUE，调用 BeginPaint 函数的时候，背景重绘 3. 如果为 FALSE，则背景保持不变

返回值：

该函数的返回值永远都是非 0。


备注：

1. 无效的区域的将会不断叠加到更新区域中，直到下一个 WM_PAINT 消息被处理，或者直到使用 ValidateRect 或 ValidateRgn 函数更新失效区域。

2. 每当窗口的更新区域不为空，并且应用程序队列中没有其他的消息，系统便发送一个 WM_PAINT 消息给窗口。

3. 指定的区域必须先被创建。

4. 如果任何一个更新区域的 bErase 参数为 TRUE，整个背景会被擦除重绘。

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