Graphics.ExcludeClip Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

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)

Quelle:

Graphics.cs

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 mit 100 x 100 Pixeln, dessen obere linke Ecke sich an der Koordinate (100, 100) befindet.

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

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

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 dieses Graphicszu.

ExcludeClip(Rectangle)

Quelle:

Graphics.cs

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 mit 100 x 100 Pixeln, dessen obere linke Ecke sich an der Koordinate (100, 100) befindet.

• Erstellt einen durch das Rechteck definierten Bereich.

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

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

Das Ergebnis ist ein blaues Rechteck mit einem quadratischen Bereich in Richtung der unteren rechten Ecke, die 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 dieses Graphicszu.