Función InvalidateRgn (winuser.h)
La función InvalidateRgn invalida el área de cliente dentro de la región especificada agregándola a la región de actualización actual de una ventana. La región invalidada, junto con todas las demás áreas de la región de actualización, se marca para pintar cuando se produce el siguiente mensaje de WM_PAINT .
Sintaxis
BOOL InvalidateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Parámetros
[in] hWnd
Identificador de la ventana con una región de actualización que se va a modificar.
[in] hRgn
Identificador de la región que se va a agregar a la región de actualización. Se supone que la región tiene coordenadas de cliente. Si este parámetro es NULL, se agrega todo el área de cliente a la región de actualización.
[in] bErase
Especifica si se debe borrar el fondo dentro de la región de actualización cuando se procesa la región de actualización. Si este parámetro es TRUE, se borra el fondo cuando se llama a la función BeginPaint . Si el parámetro es FALSE, el fondo permanece sin cambios.
Valor devuelto
El valor devuelto siempre es distinto de cero.
Comentarios
Las áreas invalidadas se acumulan en la región de actualización hasta que se procesa el siguiente mensaje de WM_PAINT o hasta que la región se valida mediante la función ValidateRect o ValidateRgn .
El sistema envía un mensaje de WM_PAINT a una ventana cada vez que su región de actualización no está vacía y no hay otros mensajes en la cola de la aplicación para esa ventana.
La región especificada debe haberse creado mediante una de las funciones de región.
Si el parámetro bErase es TRUE para cualquier parte de la región de actualización, se borra el fondo de toda la región, no solo en la parte especificada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-draw-l1-1-0 (introducido en Windows 8) |