Compartilhar via


CWnd::OnEraseBkgnd

A estrutura chama essa função de membro quando o plano de fundo do objeto de CWnd precisa apagar (por exemplo, quando redimensionado).

afx_msg BOOL OnEraseBkgnd( 
   CDC* pDC  
);

Parâmetros

  • pDC
    Especifica o objeto de dispositivo contexto.

Valor de retorno

Diferente de zero se apaga o plano de fundo; se não 0.

Comentários

é chamado para preparar uma região invalidada para pintar.

A implementação padrão apaga o plano de fundo usando o pincel do plano de fundo da classe de janela especificada pelo membro de hbrBackground estrutura de classe de janela.

Se o membro de hbrBackground é NULO, sua versão sobrecarregada de OnEraseBkgnd deve apagar a cor do plano de fundo. Sua versão deve também alinhar a fonte do pincel pretendida com as coordenadas de CWnd por primeiro UnrealizeObject chamando para o pincel, e selecione o pincel.

OnEraseBkgnd sobrescrito deve retornar diferente de zero em resposta a WM_ERASEBKGND se processa a mensagem e apaga o plano de fundo; isso indica que nenhuma caneta apagar adicional é necessário. Se retorna 0, a janela permanecerá marcada como precisam ser apagado. (Normalmente, isso significa que o membro de fErase estrutura de PAINTSTRUCT será Verdadeiro.)

As janelas assumem o plano de fundo são computadas com MM_TEXT que mapeia o modo. Se o contexto de dispositivo está usando qualquer outro modo de mapeamento, a área apagada não pode estar na parte visível da área cliente.

Dica

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::OnIconEraseBkgnd

CGdiObject::UnrealizeObject

WM_ERASEBKGND