Compartilhar via


Função ValidateRgn (winuser.h)

A função ValidateRgn valida a área do cliente dentro de uma região removendo a região da região de atualização atual da janela especificada.

Sintaxe

BOOL ValidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Parâmetros

[in] hWnd

Manipule para a janela cuja região de atualização deve ser modificada.

[in] hRgn

Identificador para uma região que define a área a ser removida da região de atualização. Se esse parâmetro for NULL, toda a área do cliente será removida.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A região especificada deve ter sido criada por uma função de região. As coordenadas de região são consideradas coordenadas do cliente.

A função BeginPaint valida automaticamente toda a área do cliente. Nem a função ValidateRect nem ValidateRgn devem ser chamadas se uma parte da região de atualização precisar ser validada antes que a próxima mensagem de WM_PAINT seja gerada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-draw-l1-1-0 (introduzido no Windows 8)

Confira também

Beginpaint

ExcludeUpdateRgn

Invalidaterect

InvalidateRgn

Funções de pintura e desenho

Visão geral de pintura e desenho

Validaterect

WM_PAINT