Função GetUpdateRect (winuser.h)
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) |