Método RectF::Union (gdiplustypes.h)

Artículo
01/10/2024

El método RectF::Union determina la unión de dos rectángulos y almacena el resultado en un objeto RectF .

Sintaxis

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

Parámetros

[out] c

Tipo: rectF&

Referencia a un objeto RectF que recibe la unión de los dos rectángulos.

[in] a

Tipo: const RectF&

Referencia a uno de los dos rectángulos usados para formar la unión.

[in] b

Tipo: const RectF&

Referencia a uno de los dos rectángulos usados para formar la unión.

Valor devuelto

Tipo: BOOL

Si la unión de dos rectángulos no está vacía, este método devuelve TRUE; de lo contrario, devuelve FALSE.

Comentarios

En GDI+, la unión de dos rectángulos es el rectángulo más pequeño que incluye los dos rectángulos. Un rectángulo se define como vacío si su ancho o alto es menor o igual que cero.

Ejemplos

En el ejemplo siguiente se crean tres rectángulos. El código forma la unión de los dos primeros rectángulos y almacena el resultado en el tercer rectángulo. El código determina si la unión no es vacía y, si es así, dibuja la unión.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplustypes.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll