RectF::Union-Methode (gdiplustypes.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

[out] c

Typ: RectF&

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

[in] a

Typ: const RectF&

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

[in] b

Typ: const RectF&

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 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 RectF objects.
   RectF rectA(50, 50, 200, 100);
   RectF rectB(70, 20, 100, 200);
   RectF 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

Anforderung	Wert
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