CWnd::GetUpdateRect

Artigo
08/25/2010

Recupera as coordenadas do retângulo menor que engloba completamente a região de atualização.

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

Parâmetros

lpRect
Aponta para um CRect objeto ou RECT estrutura que receberá as coordenadas de cliente da atualização que envolve a região de atualização.

conjunto Este parâmetro para NULO para determinar se existe uma região de atualização dentro de CWnd. If lpRect é NULO, the GetUpdateRect função de membro retorna diferente de zero se existe uma região de atualização e não a 0 se houver uma. Isso fornece uma maneira para determinar se um WM_PAINT mensagem resultou em uma área inválido. Não conjunto este parâmetro para NULO na versão 3.0 e versões anterior do Windows.
bErase
Especifica se o plano de fundo na região de atualização a serem apagados.

Valor de retorno

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

Se o lpRect parâmetro for definido como NULO, o valor retornado é diferente de zero se existe uma região de atualização; caso contrário, 0.

Comentários

If CWnd foi criado com o CS_OWNDC estilo e o modo de mapeamento não é MM_TEXT, o GetUpdateRect função de membro dá o retângulo em coordenadas lógicas. Caso contrário, GetUpdateRect permite que o retângulo no cliente de coordenadas. Se não houver nenhuma atualização de região, GetUpdateRect Define o retângulo estar vazio (define todas as coordenadas como 0).

The bErase parâmetro especifica se GetUpdateRect deve apagar o plano de fundo da região de atualização. If bErase é TRUE e a região de atualização não está vazia, o plano de fundo é apagado.Para apagar o plano de fundo, GetUpdateRect envia o WM_ERASEBKGND mensagem.

O retângulo atualização recuperado pelo BeginPaint é idêntica ao recuperados pelo função de membroGetUpdateRect função de membro.

The BeginPaint função de membro valida automaticamente a região de atualização, portanto, qualquer telefonar para GetUpdateRect feitas imediatamente após uma telefonar para BeginPaint recupera uma região de atualização vazio.