<Return[UV]><Top>

ValidateRgn

Declare Function Api_ValidateRgn& Lib "user32" Alias "ValidateRgn" (ByVal hWnd&, ByVal hRgn&)

Declare Function ValidateRgn Lib "user32" Alias "ValidateRgn" (ByVal hwnd As Long, ByVal hRgn As Long) As Long

指定されたウィンドウの現在の更新リージョンから、指定された他のリージョンを削除することにより、指定された他のリージョン内のクライアント領域を有効にする。更新リージョンとは、ウィンドウのクライアント領域のうち、再描画しなければならない部分のことである。

パラメータ
hWnd
    更新リージョンに変更を加えたいウィンドウのハンドルを指定する。このウィンドウの更新領域が変更される。
hRgn
    更新リージョンから削除したい他のリージョンのハンドルを指定する。NULL を指定すると、更新リージョンからクライアント領域全体を削除す

    る(クライアント領域全体を有効化する)。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、 関数を使う。

解説
    hRgn パラメータで指定するリージョンは、リージョン関数を使ってあらかじめ作成しておかなければならない。リージョンの座標は、クライアン

    ト座標であると見なされる。
    BeginPaint 関数は、自動的にクライアント領域全体を有効化する。次の WM_PAINT メッセージを生成する前に更新リージョンの一部を

    有効にしなければならない場合は、 ValidateRect と ValidateRgn のどちらの関数も呼び出すべきではない。