CWnd::GetUpdateRect

Artigo
02/25/2013

Recupera as coordenadas do retângulo menor que inclui completamente a área de atualização.

BOOL GetUpdateRect(
   LPRECT lpRect,
   BOOL bErase = FALSE 
);

Parâmetros

lpRect
Os pontos a CRect objeto ou as estruturas de RECT que deve receber as coordenadas do cliente de atualização que inclui a região de atualização.

Defina o parâmetro como NULO para determinar se uma região de atualização existe dentro de CWnd.Se lpRect é NULO, a função de membro de GetUpdateRect retorna diferente de zero se uma região de atualização existe e 0 se uma não.Isso fornece uma maneira de determinar se uma mensagem de WM_PAINT resultou de uma área inválido.Não defina o parâmetro como NULO na versão 3,0 do windows e anteriormente.
bErase
Especifica se o plano de fundo na região de atualização deve ser apagado.

Valor de retorno

Especifica o status da região de atualização.O valor é diferente de zero se a região de atualização é não vazio; se não 0.

Se o parâmetro de lpRect é definido como NULO, o valor de retorno é diferente de zero se uma região de atualização existir; se não 0.

Comentários

Se CWnd foi criado com o estilo de CS_OWNDC e o modo de mapeamento não é MM_TEXT, a função de membro de GetUpdateRect fornece o retângulo em coordenadas lógicas.Caso contrário, GetUpdateRect fornece o retângulo em coordenadas do cliente.Se não houver nenhuma região de atualização, GetUpdateRect define o retângulo para ser vazia (define todas as coordenadas para 0).

O parâmetro de bErase especifica se deve GetUpdateRect apagar o plano de fundo da região de atualização.Se bErase é Verdadeiro e a região de atualização não estiver vazia, o plano de fundo é apagado.Apagar o plano de fundo, GetUpdateRect envia a mensagem de WM_ERASEBKGND .

O retângulo de atualização retornado pela função de membro de BeginPaint é idêntico ao retornado pela função de membro de GetUpdateRect .

A função de membro de BeginPaint valida automaticamente a região de atualização, o que qualquer chamada a GetUpdateRect fez imediatamente após uma chamada a BeginPaint recupera uma área vazia de atualização.