CWnd::BeginPaint

Artigo
06/10/2015

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
}