Metodo Rect::Union (gdiplustypes.h)

Articolo
01/10/2024

Il metodo Rect::Union determina l'unione di due rettangoli e archivia il risultato in un oggetto Rect .

Sintassi

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

Parametri

[out] c

Tipo: &rect

Riferimento a un oggetto Rect che riceve l'unione dei due rettangoli.

[in] a

Tipo: const Rect&

Riferimento a uno dei due rettangoli utilizzati per formare l'unione.

[in] b

Tipo: const Rect&

Riferimento a uno dei due rettangoli utilizzati per formare l'unione.

Valore restituito

Tipo: BOOL

Se l'unione di due rettangoli non è vuota, questo metodo restituisce TRUE; in caso contrario, restituisce FALSE.

Commenti

In Windows GDI+, l'unione di due rettangoli è il rettangolo più piccolo che racchiude i due rettangoli. Un rettangolo viene definito come vuoto se la larghezza o l'altezza è minore o uguale a zero.

Esempio

Nell'esempio seguente vengono creati tre rettangoli. Il codice forma l'unione dei primi due rettangoli e archivia il risultato nel terzo rettangolo. Il codice determina se l'unione è nonempty e, in tal caso, disegna l'unione.

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

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplustypes.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll