CWnd::InvalidateRgn

Artigo
08/25/2010

Invalida a área de cliente em determinada região adicionando-a região corrente da atualização de CWnd.

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

Parâmetros

pRgn
Um ponteiro para um CRgn objeto que identifica a região a ser adicionado à região de atualização.Supõe-se que a região possui coordenadas do cliente.Se esse parâmetro for NULO, a área inteira do cliente é adicionada à região de atualização.
bErase
Especifica se o plano de fundo dentro da região de atualização a serem apagados.

Comentários

A região invalidada, juntamente com todas as outras áreas na região de atualização, é marcada para pintura quando o WM_PAINT mensagem a seguir é enviada.As áreas invalidadas se acumulam na região de atualização até que a região é processada quando um WM_PAINT mensagem é enviada em seguida, ou até que a região é validada pela ValidateRect or ValidateRgnfunção de membro .

The bErase parâmetro especifica se o plano de fundo da área de atualização de deve ser apagada quando a região de atualização é processada. If bErase é TRUE, o plano de fundo é apagado quando o BeginPaint função de membro é chamada; se bErase é FALSE, o plano de fundo permanece inalterado.If bErase é TRUE para qualquer parte da região de atualização, plano de fundo de toda a região, não apenas na parte determinada, é apagado.

O Windows envia um WM_PAINT mensagem sempre que o CWnd região de atualização não está vazio e não existem outras mensagens na fila de aplicativo para que a janela.

Determinada região deve ter sido criada anteriormente por uma das funções de região.