InvalidateRgn

9/9/2008

Essa função invalida a área cliente dentro da região especificada adicionando a área a atual região atualização de uma janela.

InvalidateRgn também marca a região invalidada, juntamente com todas as outras áreas na região atualização, para pintura quando o próximo WM_PAINT mensagem ocorre.

Syntax

BOOL WINAPI InvalidateRgn(
  HWND hWnd,
  HRGN hRgn,
  BOOL fErase
);

Parameters

• hWnd
  [no] Identificador para a janela que contém uma Região atualização que você desejar para modificar.

• hRgn
  [no] Identificador para a região que desejar para adicionar à região de atualização.

  InvalidateRgn pressupõe que a região tenha coordenadas cliente.

  Defina este parâmetro como NULL para adicionar a área cliente inteiro à região de atualização.

• fErase
  [no] Boolean que especifica se você desejar o segundo plano dentro da região atualização a ser apagada quando a região atualização é processada.

  TRUE indica que o segundo plano é apagado quando o BeginPaint função é chamado.

  FALSE indica que o segundo plano permanece inalterado.

Return Value

O valor de retorno é sempre diferente de zero.

Remarks

Áreas invalidadas se acumulam na região de atualização até que o aplicativo processa o próximo mensagem WM_PAINT ou até que o aplicativo valida a região por chamado de ValidateRect Ou ValidateRgn função.

O sistema envia uma mensagem WM_PAINT para uma janela sempre que a região atualização para o aplicativo não está vazio e fila de aplicativo para essa janela não contém nenhuma mensagem.

Você deve criar a região especificada usando uma das funções de região, como ExtCreateRegion.

Se a pasta fErase parâmetro é TRUE para qualquer parte da região da atualização, o segundo plano na região de toda é apagado, não apenas o segundo plano na parte especificada.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

BeginPaint
ExtCreateRegion
InvalidateRect
ValidateRect
ValidateRgn
WM_PAINT