Compartilhar via


Função InvalidateRect (winuser.h)

A função InvalidateRect adiciona um retângulo à região de atualização da janela especificada. A região de atualização representa a parte da área de cliente da janela que deve ser redesenhada.

Sintaxe

BOOL InvalidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect,
  [in] BOOL       bErase
);

Parâmetros

[in] hWnd

Um identificador para a janela cuja região de atualização foi alterada. Se esse parâmetro for NULL, o sistema invalida e redesenhará todas as janelas, não apenas as janelas desse aplicativo, e enviará as mensagens WM_ERASEBKGND e WM_NCPAINT antes que a função retorne. Não é recomendável definir esse parâmetro como NULL .

[in] lpRect

Um ponteiro para uma estrutura RECT que contém as coordenadas do cliente do retângulo a ser adicionado à região de atualização. Se esse parâmetro for NULL, toda a área do cliente será adicionada à região de atualização.

[in] bErase

Especifica se o plano de fundo dentro da região de atualização deve ser apagado quando a região de atualização é processada. Se esse parâmetro for TRUE, a tela de fundo será apagada quando a função BeginPaint for chamada. Se esse parâmetro for FALSE, a tela de fundo permanecerá inalterada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

As áreas invalidadas se acumulam na região de atualização até que a região seja processada quando o próximo WM_PAINT mensagem ocorrer ou até que a região seja validada usando a função ValidateRect ou ValidateRgn .

O sistema envia uma mensagem de WM_PAINT para uma janela sempre que sua região de atualização não estiver vazia e não houver outras mensagens na fila do aplicativo para essa janela.

Se o parâmetro bErase for TRUE para qualquer parte da região de atualização, a tela de fundo será apagada em toda a região, não apenas na parte especificada.

Exemplos

Para obter um exemplo, consulte Invalidando a área do cliente.

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)

Confira também

Beginpaint

InvalidateRgn

Funções de pintura e desenho

Visão geral de pintura e desenho

RECT

Validaterect

Validatergn

WM_ERASEBKGND

WM_NCPAINT

WM_PAINT