InvalidateRgn

小甲鱼

函数功能：

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


API 函数原型：

BOOL InvalidateRgn(
  _In_ HWND hWnd,
  _In_ HRGN hRgn,
  _In_ BOOL bErase
);

参数解析：

参数	含义
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）所有，转载请注明来源。