Función GetUpdateRgn (winuser.h)

  • Artículo

La función GetUpdateRgn recupera la región de actualización de una ventana copiándola en la región especificada. Las coordenadas de la región de actualización son relativas a la esquina superior izquierda de la ventana (es decir, son coordenadas de cliente).

Sintaxis

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

Parámetros

[in] hWnd

Controle la ventana con una región de actualización que se va a recuperar.

[in] hRgn

Identificador de la región para recibir la región de actualización.

[in] bErase

Especifica si se debe borrar el fondo de la ventana y si se deben dibujar áreas no cliente de ventanas secundarias. Si este parámetro es FALSE, no se realiza ningún dibujo.

Valor devuelto

El valor devuelto indica la complejidad de la región resultante; puede ser uno de los valores siguientes.

Value Significado
COMPLEXREGION La región consta de más de un rectángulo.
ERROR Se produjo un error.
NULLREGION La región está vacía.
SIMPLEREGION La región es un único rectángulo.

Comentarios

La función BeginPaint valida automáticamente la región de actualización, por lo que cualquier llamada a GetUpdateRgn realizada inmediatamente después de la llamada a BeginPaint recupera una región de actualización vacía.

Requisitos

   
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

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo