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) |