Rect::Union-Methode (gdiplustypes.h)

Artikel
01/10/2024

Die Rect::Union-Methode bestimmt die Vereinigung zweier Rechtecke und speichert das Ergebnis in einem Rect-Objekt .

Syntax

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

Parameter

[out] c

Typ: Rect&

Verweis auf ein Rect-Objekt , das die Vereinigung der beiden Rechtecke empfängt.

[in] a

Typ: const Rect&

Verweis auf eines der beiden Rechtecke, die zum Bilden der Union verwendet werden.

[in] b

Typ: const Rect&

Verweis auf eines der beiden Rechtecke, die zum Bilden der Union verwendet werden.

Rückgabewert

Typ: BOOL

Wenn die Union zweier Rechtecke nicht leer ist, gibt diese Methode TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

In Windows GDI+ ist die Vereinigung zweier Rechtecke das kleinste Rechteck, das die beiden Rechtecke umschließt. Ein Rechteck wird als leer definiert, wenn seine Breite oder Höhe kleiner oder gleich 0 ist.

Beispiele

Im folgenden Beispiel werden drei Rechtecke erstellt. Der Code bildet die Vereinigung der ersten beiden Rechtecke und speichert das Ergebnis im dritten Rechteck. Der Code bestimmt, ob die Union nicht leer ist, und zeichnet, wenn ja, die Union.

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);
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplustypes.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll