CWnd::BeginPaint

 

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

Syntaxe

      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é.

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

CWnd, classe
Graphique hiérarchique
CWnd::EndPaint
CWnd::Invalidate
CWnd::InvalidateRgn
BeginPaint
CPaintDC Class