CWnd::BeginPaint

Artykuł
06/10/2015

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
}