Partilhar via


CWnd::InvalidateRect

Invalida a área cliente dentro do retângulo determinado adicionando o retângulo para a região de atualização de CWnd .

void InvalidateRect(
   LPCRECT lpRect,
   BOOL bErase = TRUE 
);

Parâmetros

  • lpRect
    Os pontos a CRect objeto ou uma estrutura de RECT que contém o retângulo (em coordenadas do cliente) a ser adicionado à região de atualização.Se lpRect é NULO, toda a área cliente é adicionada à região.

  • bErase
    Especifica se o plano de fundo dentro da região de atualização deve ser apagado.

Comentários

O retângulo invalidado, junto com quaisquer outras áreas na região de atualização, é marcado pintando quando a seguinte mensagem de WM_PAINT é enviada.As áreas invalidadas acumulam na região de atualização até que a região ser processada quando a próxima chamada de WM_PAINT ocorre, ou até a região é validado pela função de membro de ValidateRect ou de ValidateRgn .

O parâmetro de bErase especifica se o plano de fundo dentro da área de atualização deve ser apagado quando a região de atualização é processada.Se bErase é Verdadeiro, o plano de fundo é apagado quando a função de membro de BeginPaint é chamada; se bErase é Falso, o plano de fundo permanece inalterado.Se bErase é Verdadeiro para qualquer parte da região de atualização, o plano de fundo na região inteira é apagado, não apenas a parte fornecida.

As janelas envia uma mensagem de WM_PAINT sempre que a região de atualização de CWnd é não vazio e não há nenhuma outra mensagem na fila do aplicativo para essa janela.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

CWnd::BeginPaint

CWnd::ValidateRect

CWnd::ValidateRgn

InvalidateRect

CWnd::Invalidate

CWnd::InvalidateRgn