Rect：：Union 方法 (gdiplustypes.h)

發行項
01/10/2024

Rect：：Union 方法會決定兩個矩形的聯集，並將結果儲存在 Rect 物件中。

語法

BOOL Union(
  [out] Rect &       c,
  [in]  const Rect & a,
  [in]  const Rect & b
);

參數

[out] c

類型： Rect&

Rect 對象的參考，該物件會接收兩個矩形的聯集。

[in] a

類型： const Rect&

用來形成等位的兩個矩形之一的參考。

[in] b

類型： const Rect&

用來形成等位的兩個矩形之一的參考。

傳回值

類型： BOOL

如果兩個矩形的聯集不是空的，這個方法會傳回 TRUE;否則會傳回 FALSE。

備註

在 Windows GDI+中，兩個矩形的聯集是括住兩個矩形的最小矩形。如果矩形的寬度或高度小於或等於零，則會定義為空白。

範例

下列範例會建立三個矩形。程序代碼會形成前兩個矩形的聯集，並將結果儲存在第三個矩形中。程式代碼會判斷聯集是否為無空，如果是，則會繪製聯集。

VOID Example_UnionABC(HDC hdc)
{
   Graphics graphics(hdc);
   Pen* pGreenPen;

   // Create three Rect objects.
   Rect rectA(50, 50, 200, 100);
   Rect rectB(70, 20, 100, 200);
   Rect rectC;

   // Determine the union of rectA and rectB, and store the result in rectC.
   if(rectC.Union(rectC, rectA, rectB))
   {
      // rectC is not empty.
      // Draw the union with a thick green pen.
      pGreenPen = new Pen(Color(255, 0, 255, 0), 7);
      graphics.DrawRectangle(pGreenPen, rectC);
      delete pGreenPen;
   }
   // Draw rectA and rectB with a thin black pen.
   Pen blackPen(Color(255, 0, 0, 0), 1);
   graphics.DrawRectangle(&blackPen, rectA);
   graphics.DrawRectangle(&blackPen, rectB);
}

規格需求


最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限桌面應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	gdiplustypes.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll