Rect ::Union, méthode (gdiplustypes.h)

Article
01/10/2024

La méthode Rect ::Union détermine l’union de deux rectangles et stocke le résultat dans un objet Rect .

Syntaxe

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

Paramètres

[out] c

Type : Rect&

Référence à un objet Rect qui reçoit l’union des deux rectangles.

[in] a

Type : const Rect&

Référence à l’un des deux rectangles utilisés pour former l’union.

[in] b

Type : const Rect&

Référence à l’un des deux rectangles utilisés pour former l’union.

Valeur retournée

Type : BOOL

Si l’union de deux rectangles n’est pas vide, cette méthode retourne TRUE ; sinon, il retourne FALSE.

Remarques

Dans Windows GDI+, l’union de deux rectangles est le plus petit rectangle qui entoure les deux rectangles. Un rectangle est défini comme vide si sa largeur ou sa hauteur est inférieure ou égale à zéro.

Exemples

L’exemple suivant crée trois rectangles. Le code forme l’union des deux premiers rectangles et stocke le résultat dans le troisième rectangle. Le code détermine si l’union est nulle et, si c’est le cas, dessine l’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);
}

Configuration requise


Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplustypes.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll