共用方式為


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

表示兩個區域合併方式的模式。 此參數可以是下列其中一個值。

意義
RGN_AND
建立兩個合併區域的交集。
RGN_COPY
建立 hrgnSrc1 所識別之區域的複本。
RGN_DIFF
結合不屬於 hrgnSrc2hrgnSrc1 部分。
RGN_OR
建立兩個合併區域的聯集。
RGN_XOR
建立兩個合併區域的聯集,但任何重疊區域除外。

傳回值

傳回值會指定結果區域的型別。 它可以是下列值之一。

傳回碼 Description
NULLREGION
區域是空的。
SIMPLEREGION
區域是單一矩形。
COMPLEXREGION
區域超過單一矩形。
ERROR
未建立任何區域。

備註

這三個區域不需要相異。 例如, hrgnSrc1 參數可以等於 hrgnDest 參數。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

區域函式

區域概觀