InvalidateRgn

InvalidateRgn 関数は指定された領域内のクライアント領域を、ウィンドウの現在の更新領域に追加することで無効化する。

InvalidateRgn hWnd, hRgn, bErase

hWnd : [intptr] 更新領域を修正するウィンドウへのハンドル。
hRgn : [intptr] 更新領域に追加するリージョンへのハンドル。このリージョンはクライアント座標とみなされる。NULL の場合、クライアント領域全体が更新領域に追加される。
bErase : [int] 更新領域の処理時に、領域内の背景を消去するかを指定する。TRUE の場合、BeginPaint が呼ばれたときに背景が消去される。FALSE の場合、背景は変更されない。

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

解説

InvalidateRgn 関数は指定された領域内のクライアント領域を、ウィンドウの現在の更新領域に追加することで無効化する。

[戻り値]
戻り値は常に 0 以外となる。

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

情報