CombineRgn 関数 (wingdi.h)

CombineRgn 関数は、2 つの領域を結合し、結果を 3 番目の領域に格納します。 2 つの領域は、指定されたモードに従って結合されます。

構文

int CombineRgn(
  [in] HRGN hrgnDst,
  [in] HRGN hrgnSrc1,
  [in] HRGN hrgnSrc2,
  [in] int  iMode
);

パラメーター

[in] hrgnDst

他の 2 つの領域を組み合わせて定義されたディメンションを持つ新しいリージョンへのハンドル。 (このリージョンは 、CombineRgn が呼び出される前に存在する必要があります)。

[in] hrgnSrc1

結合する 2 つのリージョンの最初のへのハンドル。

[in] hrgnSrc2

結合する 2 つのリージョンの 2 番目へのハンドル。

[in] iMode

2 つのリージョンを結合する方法を示すモード。 このパラメーターには、次の値のいずれかを指定できます。

意味
RGN_AND
2 つの結合領域の積集合を作成します。
RGN_COPY
hrgnSrc1 によって識別されるリージョンのコピーを作成します。
Rgn_diff
hrgnSrc2 の一部ではない hrgnSrc1 の部分を結合します。
RGN_OR
2 つの結合領域の和集合を作成します。
RGN_XOR
重複する領域を除き、2 つの結合領域の和集合を作成します。

戻り値

戻り値は、結果の領域の型を指定します。 次のいずれかの値を指定できます。

リターン コード 説明
NULLREGION
リージョンが空です。
SIMPLEREGION
領域は 1 つの四角形です。
COMPLEXREGION
領域は 1 つ以上の四角形です。
ERROR
リージョンは作成されません。

注釈

3 つのリージョンを区別する必要はありません。 たとえば、 hrgnSrc1 パラメーターは hrgnDest パラメーターと等しい場合があります。

要件

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

こちらもご覧ください

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

リージョン関数

リージョンの概要