Auf Englisch lesen

Teilen über


Graphics.ExcludeClip Methode

Definition

Aktualisiert den Clipbereich dieser Graphics, um den durch eine Rectangle Struktur angegebenen Bereich auszuschließen.

Überlädt

ExcludeClip(Region)

Aktualisiert den Clipbereich dieses Graphics, um den durch eine Regionangegebenen Bereich auszuschließen.

ExcludeClip(Rectangle)

Aktualisiert den Clipbereich dieser Graphics, um den durch eine Rectangle Struktur angegebenen Bereich auszuschließen.

ExcludeClip(Region)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Aktualisiert den Clipbereich dieses Graphics, um den durch eine Regionangegebenen Bereich auszuschließen.

C#
public void ExcludeClip(System.Drawing.Region region);

Parameter

region
Region

Region, die den bereich angibt, der aus dem Clipbereich ausgeschlossen werden soll.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt ein Rechteck mit 100 Pixeln um 100 Pixel, dessen obere linke Ecke sich an der Koordinate befindet (100, 100).

  • Legt den Clippingbereich fest, um das Rechteck auszuschließen.

  • Füllt ein Rechteck mit 300 Pixeln um 300 Pixel, dessen obere linke Ecke sich an der Koordinate (0, 0) mit einem vollblauen Pinsel befindet.

Das Ergebnis ist ein blaues Rechteck mit einem quadratischen Bereich in Richtung der unteren rechten Ecke, das fehlt.

C#
public void ExcludeClipRegion(PaintEventArgs e)
{
             
    // Create rectangle for region.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Create region for exclusion.
    Region excludeRegion = new Region(excludeRect);
             
    // Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Hinweise

Diese Methode schließt den durch den parameter region angegebenen Bereich aus dem aktuellen Clipbereich aus und weist den resultierenden Bereich der Clip-Eigenschaft dieses Graphicszu.

Gilt für:

.NET 10 (package-provided) und andere Versionen
Produkt Versionen
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

ExcludeClip(Rectangle)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Aktualisiert den Clipbereich dieser Graphics, um den durch eine Rectangle Struktur angegebenen Bereich auszuschließen.

C#
public void ExcludeClip(System.Drawing.Rectangle rect);

Parameter

rect
Rectangle

Rectangle Struktur, die das aus dem Clipbereich auszuschließende Rechteck angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt ein Rechteck mit 100 Pixeln um 100 Pixel, dessen obere linke Ecke sich an der Koordinate befindet (100, 100).

  • Erstellt einen durch das Rechteck definierten Bereich.

  • Legt den Beschneidungsbereich fest, um den rechteckigen Bereich auszuschließen.

  • Füllt ein Rechteck mit 300 Pixeln um 300 Pixel, dessen obere linke Ecke sich an der Koordinate (0, 0) mit einem vollblauen Pinsel befindet.

Das Ergebnis ist ein blaues Rechteck mit einem quadratischen Bereich in Richtung der unteren rechten Ecke, das fehlt.

C#
public void ExcludeClipRectangle(PaintEventArgs e)
{
             
    // Create rectangle for exclusion.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Hinweise

Diese Methode schließt den durch den parameter rect angegebenen Bereich aus dem aktuellen Clipbereich aus und weist den resultierenden Bereich der Clip-Eigenschaft dieses Graphicszu.

Gilt für:

.NET 10 (package-provided) und andere Versionen
Produkt Versionen
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10