CWnd::GetUpdateRect
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.
Requisitos
Cabeçalho: afxwin.h