Método Region::Union(constRect&) (gdiplusheaders.h)

Artículo
02/26/2024

El método Region::Union actualiza esta región a todas las partes (intersección e inintersección) de sí mismo y todas las partes del interior del rectángulo especificado.

Sintaxis

Status Union(
  const Rect & rect
);

Parámetros

rect

Referencia a un rectángulo que se va a usar para actualizar esta región.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Observaciones

Ejemplos

En el ejemplo siguiente se crea una región a partir de una ruta de acceso y, a continuación, se usa un rectángulo para actualizar la región. La región actualizada es la unión de la región de ruta de acceso y un rectángulo.

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