Метод RectF::Union (gdiplustypes.h)

Статья
02/29/2024

Метод RectF::Union определяет объединение двух прямоугольников и сохраняет результат в объекте RectF .

Синтаксис

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

Параметры

[out] c

Тип: RectF&

Ссылка на объект RectF , который получает объединение двух прямоугольников.

[in] a

Тип: const RectF&

Ссылка на один из двух прямоугольников, используемых для формирования объединения.

[in] b

Тип: const RectF&

Ссылка на один из двух прямоугольников, используемых для формирования объединения.

Возвращаемое значение

Тип: BOOL

Если объединение двух прямоугольников не является пустым, этот метод возвращает значение TRUE; в противном случае возвращается значение FALSE.

В GDI+ объединение двух прямоугольников является наименьшим прямоугольником, который заключает два прямоугольника. Прямоугольник определяется как пустой, если его ширина или высота меньше нуля или равна нулю.

Примеры

В следующем примере создаются три прямоугольника. Код формирует объединение первых двух прямоугольников и сохраняет результат в третьем прямоугольнике. Код определяет, является ли объединение непустимным, и, если да, то рисует объединение.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplustypes.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll