InvalidateRect

InvalidateRect 関数は、指定ウィンドウの更新領域に矩形を追加する。更新領域は、再描画が必要なクライアント領域の一部を表す。

InvalidateRect hWnd, lpRect, bErase

hWnd : [intptr] 更新領域が変化したウィンドウへのハンドル。NULL の場合、システムは当該アプリケーションだけでなくすべてのウィンドウを無効化して再描画し、関数の戻る前に WM_ERASEBKGND と WM_NCPAINT メッセージを送る。このパラメータを NULL に設定することは推奨されない。
lpRect : [var] 更新領域に追加する矩形のクライアント座標を含む RECT 構造体へのポインタ。NULL の場合、クライアント領域全体が更新領域に追加される。
bErase : [int] 更新領域の処理時に、領域内の背景を消去するかを指定する。TRUE の場合、BeginPaint が呼ばれたときに背景が消去される。FALSE の場合、背景は変更されない。

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

解説

InvalidateRect 関数は、指定ウィンドウの更新領域に矩形を追加する。更新領域は、再描画が必要なクライアント領域の一部を表す。

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。

[備考]
無効化された領域は、次の WM_PAINT メッセージが処理されるか、ValidateRect または ValidateRgn
で検証されるまで更新領域に蓄積される。ウィンドウの更新領域が空でなく、かつそのウィンドウ向けの他のメッセージがアプリケーションキューに無いとき、システムはそのウィンドウに
WM_PAINT メッセージを送る。bErase が更新領域のいずれかの部分で TRUE
の場合、指定部分だけでなく領域全体の背景が消去される。

情報