CWnd::OnPaint

[アーティクル]
08/09/2011

Windows またはアプリケーションがアプリケーションウィンドウの一部の再描画を要求するときに、フレームワークからこのメンバー関数が呼び出されます。

afx_msg void OnPaint( );

解説

UpdateWindow メンバー関数または RedrawWindow メンバー関数が呼び出されたときに、WM_PAINT メッセージが送信されます。

RDW_INTERNALPAINT フラグを設定したために RedrawWindow メンバー関数が呼び出されたときは、ウィンドウは内部描画メッセージを受け取ることがあります。この場合、ウィンドウが更新領域を持たないこともあります。ウィンドウが更新領域を持つかどうかを調べるためには、アプリケーションは GetUpdateRect メンバー関数を使う必要があります。 GetUpdateRect が 0 を返した場合は、アプリケーションから BeginPaint メンバー関数と EndPaint メンバー関数を呼び出さないでください。

WM_PAINT メッセージは、無効領域、および RDW_INTERNALPAINT フラグを設定した RedrawWindow メンバー関数の呼び出しの両方が原因で送られます。アプリケーションは、WM_PAINT メッセージが送られるごとに内部データ構造体を見て、内部的な再描画や更新が必要かどうかを調べる必要があります。

内部 WM_PAINT メッセージは、Windows から一度だけ送られます。 UpdateWindow メンバー関数を使って、内部 WM_PAINT メッセージが送られた後は、ウィンドウが無効となるか、または RDW_INTERNALPAINT フラグを設定した RedrawWindow メンバー関数が再度呼び出されるまで、WM_PAINT メッセージが送られたりポストされることはありません。

ドキュメント/ビューアプリケーションのイメージのレンダリングの詳細については、CView::OnDraw の説明を参照してください。

WM_Paint の使用方法の詳細については、Windows SDK の次のトピックを参照してください。