Region.Exclude Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.6.24327.6

Aktualisiert diese Region auf den Teil des Innenbereichs, der sich nicht mit der angegebenen Rectangle Struktur überschneidet.

Überlädt

Exclude(Region)	Aktualisiert diese Region so, dass nur der Teil des Innenbereichs enthalten ist, der sich nicht mit dem angegebenen Regionüberschneidet.
Exclude(GraphicsPath)	Aktualisiert diese Region so, dass nur der Teil des Innenbereichs enthalten ist, der sich nicht mit dem angegebenen GraphicsPathüberschneidet.
Exclude(Rectangle)	Aktualisiert diese Region so, dass nur der Teil des Inneren enthalten ist, der sich nicht mit der angegebenen Rectangle Struktur überschneidet.
Exclude(RectangleF)	Aktualisiert diese Region so, dass nur der Teil des Inneren enthalten ist, der sich nicht mit der angegebenen RectangleF Struktur überschneidet.

Exclude(Region)

Quelle:

Region.cs

Aktualisiert diese Region so, dass nur der Teil des Innenbereichs enthalten ist, der sich nicht mit dem angegebenen Regionüberschneidet.

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

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

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

Public Sub Exclude (region As Region)

Parameter

region

Region

Die Region, die von dieser Regionausgeschlossen werden soll.

Ausnahmen

ArgumentNullException

region ist null.

Beispiele

Codebeispiele finden Sie in den Methoden Exclude(RectangleF) und Complement(Region).

Exclude(GraphicsPath)

Quelle:

Region.cs

Aktualisiert diese Region so, dass nur der Teil des Innenbereichs enthalten ist, der sich nicht mit dem angegebenen GraphicsPathüberschneidet.

public:
 void Exclude(System::Drawing::Drawing2D::GraphicsPath ^ path);

public void Exclude (System.Drawing.Drawing2D.GraphicsPath path);

member this.Exclude : System.Drawing.Drawing2D.GraphicsPath -> unit

Public Sub Exclude (path As GraphicsPath)

Parameter

path

GraphicsPath

Die GraphicsPath, die von dieser Regionausgeschlossen werden soll.

Ausnahmen

ArgumentNullException

path ist null.

Beispiele

Im folgenden Codebeispiel wird der Region-Konstruktor und die methoden Exclude und Dispose veranschaulicht.

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die FillRegionExcludingPath-Methode beim Behandeln des Paint-Ereignisses des Formulars auf, wobei e als PaintEventArgsübergeben wird.

private:
   void FillRegionExcludingPath( PaintEventArgs^ e )
   {
      // Create the region using a rectangle.
      System::Drawing::Region^ myRegion = gcnew System::Drawing::Region( Rectangle(20,20,100,100) );

      // Create the GraphicsPath.
      System::Drawing::Drawing2D::GraphicsPath^ path = gcnew System::Drawing::Drawing2D::GraphicsPath;

      // Add a circle to the graphics path.
      path->AddEllipse( 50, 50, 25, 25 );

      // Exclude the circle from the region.
      myRegion->Exclude( path );

      // Retrieve a Graphics object from the form.
      Graphics^ formGraphics = e->Graphics;

      // Fill the region in blue.
      formGraphics->FillRegion( Brushes::Blue, myRegion );

      // Dispose of the path and region objects.
      delete path;
      delete myRegion;
   }

private void FillRegionExcludingPath(PaintEventArgs e)
{

    // Create the region using a rectangle.
    Region myRegion = new Region(new Rectangle(20, 20, 100, 100));

    // Create the GraphicsPath.
    System.Drawing.Drawing2D.GraphicsPath path = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25);

    // Exclude the circle from the region.
    myRegion.Exclude(path);

    // Retrieve a Graphics object from the form.
    Graphics formGraphics = e.Graphics;

    // Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion);

    // Dispose of the path and region objects.
    path.Dispose();
    myRegion.Dispose();
}

Private Sub FillRegionExcludingPath(ByVal e As PaintEventArgs)

    ' Create the region using a rectangle.
    Dim myRegion As New Region(New Rectangle(20, 20, 100, 100))

    ' Create the GraphicsPath.
    Dim path As New System.Drawing.Drawing2D.GraphicsPath

    ' Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25)

    ' Exclude the circle from the region.
    myRegion.Exclude(path)

    ' Retrieve a Graphics object from the form.
    Dim formGraphics As Graphics = e.Graphics

    ' Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion)

    ' Dispose of the path and region objects.
    path.Dispose()
    myRegion.Dispose()

End Sub

Exclude(Rectangle)

Quelle:

Region.cs

Aktualisiert diese Region so, dass nur der Teil des Inneren enthalten ist, der sich nicht mit der angegebenen Rectangle Struktur überschneidet.

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

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

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

Public Sub Exclude (rect As Rectangle)

Parameter

rect

Rectangle

Die Rectangle Struktur, die von dieser Regionausgeschlossen werden soll.

Beispiele

Ein Codebeispiel finden Sie in der Exclude(RectangleF)-Methode.

Exclude(RectangleF)

Quelle:

Region.cs

Aktualisiert diese Region so, dass nur der Teil des Inneren enthalten ist, der sich nicht mit der angegebenen RectangleF Struktur überschneidet.

public:
 void Exclude(System::Drawing::RectangleF rect);

public void Exclude (System.Drawing.RectangleF rect);

member this.Exclude : System.Drawing.RectangleF -> unit

Public Sub Exclude (rect As RectangleF)

Parameter

rect

RectangleF

Die RectangleF Struktur, die von dieser Regionausgeschlossen werden soll.

Beispiele

Das folgende Beispiel 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 und zeichnet es auf dem Bildschirm in Schwarz.

• Erstellt ein zweites Rechteck, das sich mit dem ersten schneidet und ihn rot auf den Bildschirm zeichnet.

• Erstellt einen Bereich mithilfe des ersten Rechtecks.

• Ruft den nicht eingeschlossenen Bereich des Bereichs ab, wenn er mit dem zweiten Rechteck kombiniert wird.

• Füllt den nicht abgeblendten Bereich mit Blau und zeichnet ihn auf den Bildschirm.

Beachten Sie, dass der Bereich des Bereichs, der sich nicht mit dem Rechteck überschneidet, blau gefärbt ist.

public:
   void Exclude_RectF_Example( PaintEventArgs^ e )
   {
      // Create the first rectangle and draw it to the screen in black.
      Rectangle regionRect = Rectangle(20,20,100,100);
      e->Graphics->DrawRectangle( Pens::Black, regionRect );

      // Create the second rectangle and draw it to the screen in red.
      RectangleF complementRect = RectangleF(90,30,100,100);
      e->Graphics->DrawRectangle( Pens::Red, Rectangle::Round( complementRect ) );

      // Create a region using the first rectangle.
      System::Drawing::Region^ myRegion = gcnew System::Drawing::Region( regionRect );

      // Get the nonexcluded area of myRegion when combined with
      // complementRect.
      myRegion->Exclude( complementRect );
      
      // Fill the nonexcluded area of myRegion with blue.
      SolidBrush^ myBrush = gcnew SolidBrush( Color::Blue );
      e->Graphics->FillRegion( myBrush, myRegion );
   }

public void Exclude_RectF_Example(PaintEventArgs e)
{
             
    // Create the first rectangle and draw it to the screen in black.
    Rectangle regionRect = new Rectangle(20, 20, 100, 100);
    e.Graphics.DrawRectangle(Pens.Black, regionRect);
             
    // Create the second rectangle and draw it to the screen in red.
    RectangleF complementRect = new RectangleF(90, 30, 100, 100);
    e.Graphics.DrawRectangle(Pens.Red,
        Rectangle.Round(complementRect));
             
    // Create a region using the first rectangle.
    Region myRegion = new Region(regionRect);
             
    // Get the nonexcluded area of myRegion when combined with
             
    // complementRect.
    myRegion.Exclude(complementRect);
             
    // Fill the nonexcluded area of myRegion with blue.
    SolidBrush myBrush = new SolidBrush(Color.Blue);
    e.Graphics.FillRegion(myBrush, myRegion);
}

Public Sub Exclude_RectF_Example(ByVal e As PaintEventArgs)

    ' Create the first rectangle and draw it to the screen in black.
    Dim regionRect As New Rectangle(20, 20, 100, 100)
    e.Graphics.DrawRectangle(Pens.Black, regionRect)

    ' create the second rectangle and draw it to the screen in red.
    Dim complementRect As New RectangleF(90, 30, 100, 100)
    e.Graphics.DrawRectangle(Pens.Red, _
    Rectangle.Round(complementRect))

    ' Create a region using the first rectangle.
    Dim myRegion As New [Region](regionRect)

    ' Get the nonexcluded area of myRegion when combined with
    ' complementRect.
    myRegion.Exclude(complementRect)

    ' Fill the nonexcluded area of myRegion with blue.
    Dim myBrush As New SolidBrush(Color.Blue)
    e.Graphics.FillRegion(myBrush, myRegion)
End Sub