ExtSelectClipRgn 関数 (wingdi.h)

ExtSelectClipRgn 関数は、指定したモードを使用して、指定した領域と現在のクリッピング領域を結合します。

構文

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

[in] hdc

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

[in] hrgn

選択するリージョンのハンドル。 RGN_COPY モードを指定しない限り、このハンドルは NULL にすることはできません。

[in] mode

実行する操作。次のいずれかの値を指定する必要があります。

値	意味
RGN_AND	新しいクリッピング領域は、現在のクリッピング領域と hrgn で識別される領域の重複領域を結合します。
RGN_COPY	新しいクリッピング領域は、 hrgn で識別されるリージョンのコピーです。これは SelectClipRgn と同じです。 hrgn で識別される領域が NULL の場合、新しいクリッピング領域は既定のクリッピング領域です (既定のクリッピング領域は null 領域です)。
Rgn_diff	新しいクリッピング領域は、現在のクリッピング領域の領域と、hrgn で識別される領域から除外された領域を組み合わせます。
RGN_OR	新しいクリッピング領域は、現在のクリッピング領域と hrgn で識別される領域を結合します。
RGN_XOR	新しいクリッピング領域は、現在のクリッピング領域と hrgn で識別される領域を結合しますが、重複する領域は除外します。

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

この関数が呼び出されたときにエラーが発生した場合、指定されたデバイスコンテキストの以前のクリッピング領域は影響を受けません。

ExtSelectClipRgn 関数は、指定した領域の座標がデバイス単位で指定されていることを前提としています。

hrgn パラメーターによって識別されるリージョンのコピーのみが使用されます。リージョン自体は、この呼び出しの後に再利用することも、削除することもできます。

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