Función ValidateRgn (winuser.h)

Artículo
03/13/2024

La función ValidateRgn valida el área de cliente dentro de una región quitando la región de la región de actualización actual de la ventana especificada.

Sintaxis

BOOL ValidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Parámetros

[in] hWnd

Identificador de la ventana cuya región de actualización se va a modificar.

[in] hRgn

Controle a una región que defina el área que se va a quitar de la región de actualización. Si este parámetro es NULL, se quita todo el área de cliente.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

La región especificada debe haber sido creada por una función de región. Se supone que las coordenadas de la región son coordenadas de cliente.

La función BeginPaint valida automáticamente todo el área de cliente. No se debe llamar a la función ValidateRect ni ValidateRgn si se debe validar una parte de la región de actualización antes de que se genere el siguiente mensaje de WM_PAINT .

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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-0 (introducido en Windows 8)