CWnd::BeginPaint

Articolo
02/19/2013

Prepara CWnd per il disegno e inserisce una struttura di dati PAINTSTRUCT di informazioni sul disegno.

CDC* BeginPaint(
   LPPAINTSTRUCT lpPaint 
);

Parametri

lpPaint
I punti su PAINTSTRUCT struttura che prevede di ricevere informazioni di disegno.

Valore restituito

Identifica il contesto di dispositivo per CWnd.Il puntatore può essere temporanei e non deve essere archiviata l'ambito EndPaint.

Note

La struttura di disegno contiene una struttura di dati RECT con il più piccolo rettangolo con racchiudere la regione di aggiornamento e un flag che specifica se i precedenti sono stati eliminati.

La regione di aggiornamento è impostata da Invalidare, InvalidateRect, le funzioni membro o InvalidateRgn e dal sistema dopo avere dimensioni, si sposta, crea, scorrere, oppure esegue un'altra operazione che influisce sull'area client.Se la regione di aggiornamento è contrassegnata per rimuovere, BeginPaint invia un messaggio WM_ONERASEBKGND.

Non chiamare la funzione membro BeginPaint tranne in risposta a un messaggio WM_PAINT.Ogni chiamata alla funzione membro BeginPaint deve avere una corrispondente chiamata alla funzione membro EndPaint.Se il cursore si trova nell'area da disegnare, la funzione membro BeginPaint automaticamente nasconde il cursore per impedire la eliminazione.

Esempio

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