CWnd::OnEraseBkgnd

フレームワークは、サイズ変更された場合) CWnd のオブジェクトの背景を消去する必要がある場合は、このメンバー関数を呼び出します (たとえば。

afx_msg BOOL OnEraseBkgnd(
   CDC* pDC 
);

パラメーター

  • pDC
    デバイス コンテキストのオブジェクトを指定します。

戻り値

これは、背景をオフにした場合、; それ以外の場合は 0。

解説

描画用に無効にされた領域を準備することを呼び出します。

ウィンドウ クラス構造体の hbrBackground のメンバーで指定された既定の実装では、背景をウィンドウ クラスの背景ブラシを使用してオフにします。

hbrBackground のメンバーが null場合、OnEraseBkgnd のオーバーライドされたバージョンは背景色をオフにする必要があります。使用しているバージョンは、ブラシとブラシを選択するための最初の呼び出し UnrealizeObject によって CWnd の座標と目的のブラシの原点を配置する必要があります。

オーバーライドされた OnEraseBkgndWM_ERASEBKGND に応じてメッセージを処理し、背景を指定する以外を返します。; これは、それ以上の消しゴムは必要ないことを示します。これが 0 を返す場合、ウィンドウは消去する必要があることとしてマークされたままになります。(通常、これは PAINTSTRUCT の構造体の fErase のメンバーが **[真]**であることを意味します。

Windows では、バックグラウンド モードがマップする MM_TEXT と計算されることを前提としています。デバイス コンテキストが他のマップ モードを使用すると、消去領域はクライアント領域の可視部分内でない場合もあります。

[!メモ]

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::OnIconEraseBkgnd

CGdiObject::UnrealizeObject

WM_ERASEBKGND