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 つのリージョンを結合する方法を示すモード。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
2 つの結合領域の積集合を作成します。 |
|
hrgnSrc1 によって識別されるリージョンのコピーを作成します。 |
|
hrgnSrc2 の一部ではない hrgnSrc1 の部分を結合します。 |
|
2 つの結合領域の和集合を作成します。 |
|
重複する領域を除き、2 つの結合領域の和集合を作成します。 |
戻り値
戻り値は、結果の領域の型を指定します。 次のいずれかの値を指定できます。
| リターン コード | 説明 |
|---|---|
|
リージョンが空です。 |
|
領域は 1 つの四角形です。 |
|
領域は 1 つ以上の四角形です。 |
|
リージョンは作成されません。 |
注釈
3 つのリージョンを区別する必要はありません。 たとえば、 hrgnSrc1 パラメーターは hrgnDest パラメーターと等しい場合があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |