GetUpdateRect

9/9/2008

Essa função recupera as coordenadas do retângulo menor que inclui completamente a região atualização da janela especificada no cliente coordenadas.

Se não houver nenhuma região atualização, GetUpdateRect Recupera um vazio retângulo; Ele define todas as coordenadas para zero.

Syntax

BOOL GetUpdateRect( 
  HWND hWnd, 
  LPRECT lpRect, 
  BOOL bErase
); 

Parameters

• hWnd
  Identificador para a janela com uma região atualização que deve ser recuperada.

• lpRect
  Ponteiro longo para o RECT estrutura que recebe as coordenadas do retângulo delimitador.

  Um aplicativo pode definir esse parâmetro para NULL para determinar se existe uma região atualização para a janela.

  Se este parâmetro é NULL, GetUpdateRect Retorna diferente de zero se existe uma região atualização, e zero se não.

  Isso fornece um meio simples e eficiente de determinar se um WM_PAINTmessage resultou de um inválido área.

• bErase
  Boolean que especifica se o segundo plano na região de atualização está para ser apagados.

  Se este parâmetro é TRUE e a região atualização não estiver vazio, GetUpdateRect Envia uma mensagem WM_ERASEBKGND para a janela especificada para apagar o segundo plano.

Return Value

Nonzero indica que a região atualização não está vazio.

Zero indica que não há região nenhuma atualização.

Para informações de erro estendidas get, chamar GetLastError.

Remarks

O retângulo atualização recuperados pelo BeginPaint função é idêntica ao que recuperada por GetUpdateRect.

BeginPaint automaticamente valida a região, portanto, qualquer chamar para atualização GetUpdateRect feitas imediatamente após a chamar para BeginPaint Recupera um vazio região atualização.

Requirements

Header	winuser.h
Library	coredll.lib, Winmgr.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

BeginPaint
GetUpdateRgn
InvalidateRect
UpdateWindow
ValidateRect
RECT