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

Artigo
03/05/2024

O método RectF::Union determina a união de dois retângulos e armazena o resultado em um objeto RectF .

Sintaxe

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

Parâmetros

[out] c

Tipo: &RectF

Referência a um objeto RectF que recebe a união dos dois retângulos.

[in] a

Tipo: const RectF&

Referência a um dos dois retângulos usados para formar a união.

[in] b

Tipo: const RectF&

Referência a um dos dois retângulos usados para formar a união.

Retornar valor

Tipo: BOOL

Se a união de dois retângulos não estiver vazia, esse método retornará TRUE; caso contrário, retornará FALSE.

Comentários

No GDI+, a união de dois retângulos é o menor retângulo que inclui os dois retângulos. Um retângulo é definido como vazio se sua largura ou altura for menor ou igual a zero.

Exemplos

O exemplo a seguir cria três retângulos. O código forma a união dos dois primeiros retângulos e armazena o resultado no terceiro retângulo. O código determina se a união não é íntegra e, nesse caso, desenha a união.

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	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplustypes.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll