Compartir a través de


Función ValidateRgn (winuser.h)

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)

Consulte también

BeginPaint

ExcludeUpdateRgn

InvalidateRect

InvalidateRgn

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo

ValidateRect

WM_PAINT