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 で識別される領域を結合しますが、重複する領域は除外します。

戻り値

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

リターン コード 説明
NULLREGION
 リージョンが空です。
SIMPLEREGION
 Region は 1 つの四角形です。
COMPLEXREGION
 領域は複数の四角形です。
ERROR
 エラーが発生しました。

解説

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

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

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

要件

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

こちらもご覧ください

クリッピング関数

クリッピングの概要

SelectClipRgn