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

2024-01-10

Die Region::Exclude-Methode aktualisiert diese Region auf den Teil selbst, der sich nicht über das Innere des angegebenen Rechtecks schneidet.

Syntax

Status Exclude(
  const Rect & rect
);

Parameter

rect

Verweis auf ein Rechteck, das zum Aktualisieren dieses Region-Objekts 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.

VOID Example_ExcludeRect(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);

   // Exclude a rectangle from the path region.
   pathRegion.Exclude(rect);

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