CWnd::BeginPaint

CWnd を描画用に準備し、描画に関する情報で PAINTSTRUCT のデータ構造を塗りつぶします。

CDC* BeginPaint(
   LPPAINTSTRUCT lpPaint 
);

パラメーター

  • lpPaint
    PAINTSTRUCT をポイントし、構成します描画情報を受け取ることです。

戻り値

CWndのデバイス コンテキストを識別します。ポインターは、一時的なポインターです EndPaintの範囲を超える格納しないでください。

解説

描画の構造は完全に更新領域と背景が出力されるかどうかを指定するフラグを囲む最小の四角形がある RECT のデータ構造があります。

更新領域は 無効にします。InvalidateRectして設定、または変更された後でシステムによって InvalidateRgn のメンバー関数は、クライアント領域に影響するそのほかの演算が実行されるか、作成するか、スクロール、または実行します。更新領域を消去するのマークが付いている場合は、BeginPaintWM_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
}

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::EndPaint

CWnd::Invalidate

CWnd::InvalidateRgn

BeginPaint

CPaintDC クラス