Partilhar via


CWnd::BeginPaint

Prepara CWnd pintando e preenche uma estrutura de dados de PAINTSTRUCT com informações sobre a pintura.

CDC* BeginPaint(
   LPPAINTSTRUCT lpPaint 
);

Parâmetros

  • lpPaint
    Os pontos a PAINTSTRUCT estrutura que é receber informação de pintura.

Valor de retorno

Identifica o contexto de dispositivo para CWnd.O ponteiro pode ser temporário e não deve ser armazenado além do escopo de EndPaint.

Comentários

A estrutura de pintura contém uma estrutura de dados de RECT que tenha o retângulo o menor que inclui completamente a área de atualização e um sinalizador que especifica se o plano de fundo foi apagado.

A região de atualização é definida por invalide, InvalidateRect, ou funções de membro de InvalidateRgn e pelo sistema após redimensiona, mover, criam-se, rola, ou executam-se qualquer outra operação que afetar a área cliente.Se a região de atualização está marcada, apagando BeginPaint envia uma mensagem de WM_ONERASEBKGND .

Não chamar a função de membro de BeginPaint exceto em resposta a uma mensagem de WM_PAINT .Cada chamada para a função de membro de BeginPaint deve ter uma chamada correspondente na função de membro de EndPaint .Se o acento circunflexo na área é pintada seja, a função de membro de BeginPaint oculta automaticamente o acento circunflexo para impedir que é apagado.

Exemplo

// Use BeginPaint and EndPaint when responding to WM_PAINT message
// An alternative method is to use CPaintDC in place of 
// BeginPaint and EndPaint
void CMdiView::OnPaint() 
{
   PAINTSTRUCT ps;
   CDC* pDC = BeginPaint(&ps);

   pDC->Rectangle(CRect(0, 0, 100, 100));

   EndPaint(&ps);

   // Do not call CView::OnPaint() for painting messages
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

CWnd::EndPaint

CWnd::Invalidate

CWnd::InvalidateRgn

BeginPaint

Classe de CPaintDC