<Return[S]><Top>

SetMetaRgn

Declare Function Api_SetMetaRgn& Lib "gdi32" Alias "SetMetaRgn" (ByVal hDC&)

Declare Function SetMetaRgn Lib "gdi32" Alias "SetMetaRgn" (ByVal hdc As Long) As Long

指定したデバイスコンテキストの現在のクリッピング領域と現在のメタ領域の交差部分を求め、結合された領域をそのデバイスコンテキストの新しいメタ領域として保存する。クリッピング領域は、NULL 領域にリセットされる。

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。

戻り値
    新しいクリッピング領域の状態が返ります。次のいずれかの値が返る。
 

    値                             

意味                                                                                         

    NULLREGION

領域は空である。

    SIMPLEREGION

領域は、1 つの長方形である。

    COMPLEXREGION

領域は、複数の長方形である。

    ERROR

エラーが発生した(直前に使用したクリッピング領域は影響を受けない)。


解説
    デバイスコンテキストの現在のクリッピング領域は、クリッピング領域とメタ領域が交わる部分として定義される。
    SetMetaRgn 関数は、SaveDC 関数でアプリケーションの元のデバイスコンテキストを保存してから呼び出す。