Метод Region::Union(constRect&) (gdiplusheaders.h)

Статья
02/29/2024

Метод Region::Union обновляет эту область для всех частей (пересекающихся и неинтерсекционных) себя и всех частей внутренней части указанного прямоугольника.

Синтаксис

Status Union(
  const Rect & rect
);

Параметры

rect

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

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

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Remarks

Примеры

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

VOID Example_UnionRect(HDC hdc)
{
   Graphics graphics(hdc);

   Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   Rect rect(65, 15, 70, 45);
   GraphicsPath path;
   SolidBrush solidBrush(Color(255, 255, 0, 0));

   path.AddClosedCurve(points, 6);

   // Create a region from a path.
   Region pathRegion(&path);

   // Form the union of the region and a rectangle.
   pathRegion.Union(rect);

   graphics.FillRegion(&solidBrush, &pathRegion);
}