InvalidateRect
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função adiciona um retângulo à região da janela especificada atualização. A região atualização representa a parte da área cliente da janela que deve ser redesenhada.
Syntax
BOOL InvalidateRect(
HWND hWnd,
const RECT* lpRect,
BOOL bErase
);
Parameters
hWnd
Identificador para a janela cujo região atualização foi alterado.Se você transmitir um NULL valor para este parâmetro InvalidateRect Não leva nenhuma ação e retorna FALSE.
lpRect
Ponteiro longo para um RECT estrutura que contém as coordenadas do retângulo a ser adicionado à região de atualização de cliente.Se este parâmetro é NULL, a área cliente inteiro é adicionada à região de atualização.
bErase
Boolean que especifica se o segundo plano dentro da região atualização está para ser apagada quando a região atualização é processada.Se este parâmetro for TRUE, o segundo plano é apagado quando o BeginPaint função é chamado.
Se este parâmetro é FALSE, o segundo plano permanece inalterado.
Return Value
Nonzero indica sucesso.
Zero indica falha.
Para informações de erro estendidas get, chamar GetLastError.
Para informações de erro estendidas get, chamar GetLastError.
Remarks
O hWnd parâmetro não pode ser NULL.
As áreas invalidadas se acumulam na região de atualização até que a região é processada quando o próximo WM_PAINT mensagem ocorre ou até que a região é validada usando o ValidateRect função.
O sistema envia um WM_PAINTmessage para uma janela sempre que sua região atualização não está vazio e existem há outras mensagens na fila de aplicativo para essa janela.
Se a pasta bErase parâmetro é TRUE para qualquer parte da região da atualização, o segundo plano é apagado na região inteira, não apenas na parte determinada.
Requirements
| Header | winuser.h |
| Library | coredll.lib, Winmgr.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |