Graphics.ExcludeClip Methode

Definition

Aktualisiert den Ausschneidebereich dieses Graphics, um den durch eine Rectangle-Struktur angegebenen Bereich auszuschließen.

Überlädt

ExcludeClip(Region)

Aktualisiert den Ausschneidebereich dieses Graphics, um den durch einen Region angegebenen Bereich auszuschließen.

ExcludeClip(Rectangle)

Aktualisiert den Ausschneidebereich dieses Graphics, um den durch eine Rectangle-Struktur angegebenen Bereich auszuschließen.

ExcludeClip(Region)

Aktualisiert den Ausschneidebereich dieses Graphics, um den durch einen Region angegebenen 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, der den Bereich angibt, der aus dem Ausschneidebereich ausgeschlossen werden soll.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

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

  • Legt den Abschneidebereich so fest, dass das Rechteck ausgeschlossen wird.

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

Das Ergebnis ist ein blaues Rechteck, dessen quadratische Fläche in Richtung der unteren rechten Ecke 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 region Parameter angegebenen Bereich aus dem aktuellen Clipbereich aus und weist den resultierenden Bereich der Clip Eigenschaft dieser Graphicszu.

Gilt für:

ExcludeClip(Rectangle)

Aktualisiert den Ausschneidebereich dieses 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 Rechteck angibt, das aus dem Ausschneidebereich ausgeschlossen wird.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

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

  • Erstellt eine durch das Rechteck definierte Region.

  • Legt den Beschneidungsbereich so fest, dass der rechteckige Bereich ausgeschlossen wird.

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

Das Ergebnis ist ein blaues Rechteck, dessen quadratischer Bereich in Richtung der unteren rechten Ecke 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 rect Parameter angegebenen Bereich aus dem aktuellen Clipbereich aus und weist den resultierenden Bereich der Clip Eigenschaft dieser Graphicszu.

Gilt für: