CombineRgn 函式 (wingdi.h)
CombineRgn 函式會結合兩個區域，並將結果儲存在第三個區域中。 這兩個區域會根據指定的模式合併。
語法
int CombineRgn(
[in] HRGN hrgnDst,
[in] HRGN hrgnSrc1,
[in] HRGN hrgnSrc2,
[in] int iMode
);
參數
[in] hrgnDst
新區域的句柄，其中包含藉由結合其他兩個區域所定義的維度。 (在 呼叫 CombineRgn 之前必須存在此區域。)
[in] hrgnSrc1
要合併之兩個區域的前一個句柄。
[in] hrgnSrc2
要合併之兩個區域之第二個區域的句柄。
[in] iMode
表示兩個區域合併方式的模式。 此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
建立兩個合併區域的交集。 |
|
建立 hrgnSrc1 所識別之區域的複本。 |
|
結合不屬於 hrgnSrc2 的 hrgnSrc1 部分。 |
|
建立兩個合併區域的聯集。 |
|
建立兩個合併區域的聯集，但任何重疊區域除外。 |
傳回值
傳回值會指定結果區域的型別。 它可以是下列值之一。
| 傳回碼 | Description |
|---|---|
|
區域是空的。 |
|
區域是單一矩形。 |
|
區域超過單一矩形。 |
|
未建立任何區域。 |
備註
這三個區域不需要相異。 例如， hrgnSrc1 參數可以等於 hrgnDest 參數。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | wingdi.h (包含 Windows.h) |
| 程式庫 | Gdi32.lib |
| Dll | Gdi32.dll |