Partager via


CWnd::BeginPaint

Prépare CWnd pour peindre et remplit la structure de données d' PAINTSTRUCT d'informations sur la peinture.

CDC* BeginPaint( 
   LPPAINTSTRUCT lpPaint  
);

Paramètres

  • lpPaint
    Les points à PAINTSTRUCT structure qui est de recevoir les informations de peinture.

Valeur de retour

Identifie le contexte de périphérique pour CWnd. Le pointeur peut être temporaire et ne doit pas être inscrit le cadre de EndPaint.

Notes

La structure de peinture contient une structure de données de RECT ayant le plus petit rectangle qui englobe complètement la zone de mise à jour et un indicateur qui spécifie si l'arrière-plan a été supprimé.

La zone de mise à jour est définie par Invalidez, InvalidateRect, ou les fonctions membres d' InvalidateRgn et par le système après sa classe, passe, les crée, défile, ou exécute une autre opération qui affecte la zone cliente. Si la zone de mise à jour est marquée pour le supprimer, BeginPaint envoie un message de WM_ONERASEBKGND .

N'appelez pas la fonction membre d' BeginPaint sauf en réponse à un message de WM_PAINT . Chaque appel à la fonction membre d' BeginPaint doit avoir un appel correspondant à la fonction membre d' EndPaint . Si le signe insertion est dans la zone à peindre, la fonction membre d' BeginPaint masque automatiquement le signe insertion pour l'empêcher d'être supprimé.

Exemple

// 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
}

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

CWnd::EndPaint

CWnd::Invalidate

CWnd::InvalidateRgn

BeginPaint

CPaintDC, classe