Função GetUpdateRect (winuser.h)

Artigo
08/27/2023

A função GetUpdateRect recupera as coordenadas do menor retângulo que inclui completamente a região de atualização da janela especificada. GetUpdateRect recupera o retângulo em coordenadas lógicas. Se não houver nenhuma região de atualização, GetUpdateRect recuperará um retângulo vazio (define todas as coordenadas como zero).

Sintaxe

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

Parâmetros

[in] hWnd

Manipule para a janela cuja região de atualização deve ser recuperada.

[out] lpRect

Ponteiro para a estrutura RECT que recebe as coordenadas, em unidades de dispositivo, do retângulo delimitador.

Um aplicativo pode definir esse parâmetro como NULL para determinar se existe uma região de atualização para a janela. Se esse parâmetro for NULL, GetUpdateRect retornará diferente de zero se houver uma região de atualização e zero se não existir. Isso fornece um meio simples e eficiente de determinar se uma mensagem de WM_PAINT resultou de uma área inválida.

[in] bErase

Especifica se a tela de fundo dentro da região de atualização deve ser apagada. Se esse parâmetro for TRUE e a região de atualização não estiver vazia, GetUpdateRect enviará uma mensagem WM_ERASEBKGND para a janela especificada para apagar a tela de fundo.

Valor retornado

Se a região de atualização não estiver vazia, o valor retornado será diferente de zero.

Se não houver nenhuma região de atualização, o valor retornado será zero.

Comentários

O retângulo de atualização recuperado pela função BeginPaint é idêntico ao recuperado por GetUpdateRect.

BeginPaint valida automaticamente a região de atualização, portanto, qualquer chamada para GetUpdateRect feita imediatamente após a chamada para BeginPaint recupera uma região de atualização vazia.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-draw-l1-1-0 (introduzido no Windows 8)