Region::Union(constRect&)-Methode (gdiplusheaders.h)

Artikel
02/26/2024

Die Region::Union-Methode aktualisiert diese Region auf alle Teile (sich überschneidend und nicht überschneidend) von sich selbst und allen Teilen des Innenbereichs des angegebenen Rechtecks.

Syntax

Status Union(
  const Rect & rect
);

Parameter

rect

Verweis auf ein Rechteck, das zum Aktualisieren dieser Region verwendet werden soll.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Bemerkungen

Beispiele

Im folgenden Beispiel wird eine Region aus einem Pfad erstellt und dann ein Rechteck verwendet, um die Region zu aktualisieren. Die aktualisierte Region ist die Vereinigung der Pfadregion und eines Rechtecks.

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