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

Article
03/01/2024

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

Syntaxe

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

Paramètres

[out] c

Type : RectF&

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

[in] a

Type : const RectF&

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

[in] b

Type : const RectF&

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, elle retourne FALSE.

Remarques

Dans GDI+, l’union de deux rectangles est le plus petit rectangle qui les entoure. 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 n’est pas vide et, le cas échéant, dessine l’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);}

Configuration requise

Condition requise	Valeur
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