SetMetaRgn 関数 (wingdi.h)

SetMetaRgn 関数は、指定したデバイスコンテキストの現在のクリッピング領域と現在のメタリージョンと交差し、結合された領域を指定したデバイスコンテキストの新しいメタリージョンとして保存します。クリッピング領域は null 領域にリセットされます。

構文

int SetMetaRgn(
  [in] HDC hdc
);

[in] hdc

デバイスコンテキストへのハンドル。

戻り値は、新しいクリッピング領域の複雑さを指定し、次のいずれかの値を指定できます。

リターンコード	説明
NULLREGION	リージョンが空です。
SIMPLEREGION	Region は 1 つの四角形です。
COMPLEXREGION	領域は複数の四角形です。
ERROR	エラーが発生しました。 (前のクリッピング領域は影響を受けません)。

デバイスコンテキストの現在のクリッピング領域は、そのクリッピング領域とそのメタ領域の交差部分によって定義されます。

SetMetaRgn 関数は、アプリケーションの元のデバイスコンテキストが SaveDC 関数を呼び出して保存された後にのみ呼び出す必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll