CWnd::BeginPaint

Artykuł
02/27/2013

Przygotowuje CWnd do malowania i wypełnienia PAINTSTRUCT struktury danych z informacjami o malowanie.

CDC* BeginPaint(
   LPPAINTSTRUCT lpPaint 
);

Parametry

lpPaint
Wskazuje na PAINTSTRUCT struktury do odbierania informacji malowania.

Wartość zwracana

Identyfikuje kontekstu urządzenia do CWnd.Wskaźnik może być tymczasowy i nie powinny być przechowywane poza zakres EndPaint.

Uwagi

Struktura programu paint zawiera RECT struktury danych, który ma najmniejszego prostokąta, który całkowicie wypełnia regionu aktualizacji i Flaga określająca, czy tło zostały wymazane.

Region aktualizacji jest ustawiany przez Invalidate, InvalidateRect, lub InvalidateRgn Członkowskich funkcje i przez system po jej rozmiary, przenosi, tworzy, Przewija lub wykonuje dowolną operację, która wpływa na obszarze klienta.Jeśli region aktualizacji jest oznaczony wymazywania, BeginPaint wysyła WM_ONERASEBKGND wiadomości.

Nie wywołuj BeginPaint Członkowskich funkcji, z wyjątkiem w odpowiedzi na WM_PAINT wiadomości.Każde wywołanie BeginPaint Członkowskich funkcja musi mieć dopasowywania wywołania EndPaint funkcji składowej.Jeśli kursor znajduje się w obszarze namalowane, BeginPaint Członkowskich funkcji automatycznie ukrywa daszka, aby zapobiec wymazywania.

Przykład

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