Compartilhar via


CWnd::InvalidateRgn

Invalida a área cliente dentro da região determinada adicionando à região atual de atualização de CWnd.

void InvalidateRgn(
   CRgn* pRgn,
   BOOL bErase = TRUE 
);

Parâmetros

  • pRgn
    Um ponteiro para um objeto de CRgn que identifica a região a ser adicionada a região de atualização.A região é assumida para ter coordenadas do cliente.Se esse parâmetro é NULO, toda a área cliente é adicionada à região de atualização.

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

Comentários

A região invalidada, junto com quaisquer outras áreas na região de atualização, é marcada como quando pintando a mensagem de WM_PAINT é enviada em seguida.As áreas invalidadas acumulam na região de atualização até que a região ser processada quando uma mensagem de WM_PAINT é enviada em seguida, 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, não apenas a parte fornecida, é apagado.

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.

A região determinada deve ter sido criada anteriormente por uma das funções da região.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

CWnd::BeginPaint

CWnd::ValidateRect

CWnd::ValidateRgn

InvalidateRgn

CWnd::Invalidate

CWnd::InvalidateRect