Graphics.ExcludeClip Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

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)

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

public:
 void ExcludeClip(System::Drawing::Region ^ region);

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

member this.ExcludeClip : System.Drawing.Region -> unit

Public Sub ExcludeClip (region As 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.

public:
   void ExcludeClipRegion( PaintEventArgs^ e )
   {
      // Create rectangle for region.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Create region for exclusion.
      System::Drawing::Region^ excludeRegion = gcnew System::Drawing::Region( excludeRect );

      // Set clipping region to exclude region.
      e->Graphics->ExcludeClip( excludeRegion );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

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

Public Sub ExcludeClipRegion(ByVal e As PaintEventArgs)

    ' Create rectangle for region.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Create region for exclusion.
    Dim excludeRegion As 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)
End Sub

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.

ExcludeClip(Rectangle)

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

public:
 void ExcludeClip(System::Drawing::Rectangle rect);

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

member this.ExcludeClip : System.Drawing.Rectangle -> unit

Public Sub ExcludeClip (rect As Rectangle)

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.

public:
   void ExcludeClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for exclusion.
      Rectangle excludeRect = 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( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

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

Public Sub ExcludeClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for exclusion.
    Dim excludeRect As 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)
End Sub

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.