Função ValidateRect (winuser.h)

Artigo
08/28/2023

A função ValidateRect valida a área do cliente dentro de um retângulo removendo o retângulo da região de atualização da janela especificada.

Sintaxe

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

Parâmetros

[in] hWnd

Manipule para a janela cuja região de atualização deve ser modificada. Se esse parâmetro for NULL, o sistema invalida e redesenhará todas as janelas e enviará as mensagens WM_ERASEBKGND e WM_NCPAINT para o procedimento de janela antes que a função retorne.

[in] lpRect

Ponteiro para uma estrutura RECT que contém as coordenadas do cliente do retângulo a ser removido 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 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.

O sistema continua gerando mensagens WM_PAINT até que a região de atualização atual seja validada.

Requisitos


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)