CWnd::BeginPaint

發行項
02/28/2013

CWnd 準備用於繪製並用關於繪製的資訊填入 PAINTSTRUCT 資料結構。

CDC* BeginPaint(
   LPPAINTSTRUCT lpPaint 
);

參數

lpPaint
為 PAINTSTRUCT 的點結構是取得繪製資訊。

傳回值

識別 CWnd的裝置內容。指標可能是暫時的，而且不應儲存 EndPaint超過的範圍之外。

備註

繪製結構包含具有最小矩形完全圍住更新區域和旗標來指定的的長度資料結構是否要清除的背景。

更新區域設定無效， InvalidateRect或 InvalidateRgn 成員函式和由系統，其大小，移動，建立，捲動或執行影響的工作區域的作業之後。如果更新區域為了清除標示為， BeginPaint 傳送 WM_ONERASEBKGND 資訊。

不要呼叫除了回應 WM_PAINT 訊息的 BeginPaint 成員函式。為 BeginPaint 成員函式的每一個呼叫中必須有對應的呼叫 EndPaint 成員函式。如果插入號位於要繪製的區域， BeginPaint 成員函式自動隱藏插入號防止其清除。

範例

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