Compartir a través de


Función GetUpdateRect (winuser.h)

La función GetUpdateRect recupera las coordenadas del rectángulo más pequeño que incluye completamente la región de actualización de la ventana especificada. GetUpdateRect recupera el rectángulo en coordenadas lógicas. Si no hay ninguna región de actualización, GetUpdateRect recupera un rectángulo vacío (establece todas las coordenadas en cero).

Sintaxis

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

Parámetros

[in] hWnd

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

[out] lpRect

Puntero a la estructura RECT que recibe las coordenadas, en unidades de dispositivo, del rectángulo envolvente.

Una aplicación puede establecer este parámetro en NULL para determinar si existe una región de actualización para la ventana. Si este parámetro es NULL, GetUpdateRect devuelve un valor distinto de cero si existe una región de actualización y cero si no existe una. Esto proporciona un medio sencillo y eficaz para determinar si un mensaje de WM_PAINT resultó de un área no válida.

[in] bErase

Especifica si el fondo de la región de actualización debe borrarse. Si este parámetro es TRUE y la región de actualización no está vacía, GetUpdateRect envía un mensaje de WM_ERASEBKGND a la ventana especificada para borrar el fondo.

Valor devuelto

Si la región de actualización no está vacía, el valor devuelto es distinto de cero.

Si no hay ninguna región de actualización, el valor devuelto es cero.

Comentarios

El rectángulo de actualización recuperado por la función BeginPaint es idéntico al recuperado por GetUpdateRect.

BeginPaint valida automáticamente la región de actualización, por lo que cualquier llamada a GetUpdateRect 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

BeginPaint

GetUpdateRgn

InvalidateRect

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo

RECT

UpdateWindow

ValidateRect