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 da hierarquia

CWnd::BeginPaint

CWnd::ValidateRect

CWnd::ValidateRgn

InvalidateRgn

CWnd::Invalidate

CWnd::InvalidateRect