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) |