Função InvalidateRgn (winuser.h)
A função InvalidateRgn invalida a área do cliente dentro da região especificada adicionando-a à região de atualização atual de uma janela. A região invalidada, juntamente com todas as outras áreas na região de atualização, é marcada para pintura quando o próximo WM_PAINT mensagem ocorrer.
Sintaxe
BOOL InvalidateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Parâmetros
[in] hWnd
Um identificador para a janela com uma região de atualização que deve ser modificada.
[in] hRgn
Um identificador para a região a ser adicionada à região de atualização. Supõe-se que a região tenha coordenadas do cliente. Se esse parâmetro for NULL, toda a área do cliente será adicionada à região de atualização.
[in] bErase
Especifica se a tela de fundo dentro da região de atualização deve ser apagada 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 o parâmetro for FALSE, a tela de fundo permanecerá inalterada.
Retornar valor
O valor retornado é sempre diferente de zero.
Comentários
As áreas invalidadas se acumulam na região de atualização até que o próximo WM_PAINT mensagem seja processado 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.
A região especificada deve ter sido criada usando uma das funções de região.
Se o parâmetro bErase for TRUE para qualquer parte da região de atualização, a tela de fundo em toda a região será apagada, não apenas na parte especificada.
Requisitos
| Requisito | Valor |
|---|---|
| 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) |