<Return[S]><Top>

SelectClipRgn

Declare Function Api_SelectClipRgn& Lib "gdi32" Alias "SelectClipRgn" (ByVal hDC&, ByVal hRgn&)

Declare Function SelectClipRgn Lib "gdi32" (ByVal hDC As Long, ByVal hRgn As Long) As Long

指定されたリージョンを、指定されたデバイスコンテキストの現在のクリッピングリージョンとして選択する。

パラメータ

hdc
    デバイスコンテキストのハンドルを指定する。
hrgn
    選択対象のリージョンのハンドルを指定する。

戻り値
    関数から制御が返ると、新しいクリッピングリージョンの複雑度が返る。これは、次の値のいずれかになる。

    値                             

意味                                                                                                                                             

    NULLREGION

クリッピングリージョンは空。

    SIMPLEREGION

クリッピングリージョンは単一の長方形。

    COMPLEXREGION

クリッピングリージョンは単一の長方形よりも複雑な形。

    ERROR

エラーが発生した（以前のクリッピング領域に影響はない）。

    Windows NT/2000：拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    この関数が使うのは、指定されたリージョンのコピーだけである。

    指定されたリージョンそのものは、この関数を呼び出した後も有効であるし、削除することもできる。
    この関数は、リージョンの座標がデバイス単位で指定されているものと仮定する。
    デバイスコンテキストのクリッピングリージョンを削除するには、hrgn パラメータに NULL を指定する。