BeginPaint

BeginPaint 関数は、指定されたウィンドウを描画用に準備し、PAINTSTRUCT 構造体に描画情報を書き込む。

BeginPaint hWnd, lpPaint

hWnd : [intptr] 再描画するウィンドウへのハンドル。
lpPaint : [var] 描画情報を受け取る PAINTSTRUCT 構造体へのポインタ。

(プラグイン / モジュール : user32.dll)

解説

BeginPaint 関数は、指定されたウィンドウを描画用に準備し、PAINTSTRUCT 構造体に描画情報を書き込む。

[戻り値]
関数が成功した場合、戻り値は指定されたウィンドウのディスプレイデバイスコンテキストへのハンドル。関数が失敗した場合、戻り値は NULL
で、利用可能なディスプレイデバイスコンテキストがないことを示す。

[備考]
BeginPaint 関数は、デバイスコンテキストのクリッピング領域を更新領域外を除外するように自動的に設定する。更新領域は
InvalidateRect または InvalidateRgn
関数によって設定され、また、サイズ変更、移動、作成、スクロール、その他クライアント領域に影響する操作の後にシステムによって設定される。更新領域が消去対象としてマークされている場合、BeginPaint
はウィンドウに WM_ERASEBKGND メッセージを送信する。アプリケーションは WM_PAINT メッセージへの応答以外で
BeginPaint を呼ぶべきではない。BeginPaint の呼び出しごとに対応する EndPaint
呼び出しが必要である。キャレットが描画される領域内にある場合、BeginPaint
はキャレットが消去されないように自動的に非表示にする。ウィンドウのクラスが背景ブラシを持つ場合、BeginPaint
はそのブラシを使って更新領域の背景を消去してから戻る。DPI 仮想化: この API は DPI
仮想化に参加しない。返される出力は常に物理ピクセル単位である。

情報