Region.Exclude Methode

Definitie

Naamruimte:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Pakket:
System.Drawing.Common v11.0.0-preview.4.26230.115

Hiermee wordt dit Region bijgewerkt naar het gedeelte van het interieur dat niet met de opgegeven Rectangle structuur kruist.

Overloads

Name Description
Exclude(Region)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven Regionintersect.
Exclude(GraphicsPath)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven GraphicsPathintersect.
Exclude(Rectangle)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven Rectangle structuur kruist.
Exclude(RectangleF)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven RectangleF structuur kruist.

Exclude(Region)

Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven Regionintersect.

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)

Parameters

region
Region

De Region om uit te sluiten van dit Region.

Uitzonderingen

ArgumentNullException

region is null.

Voorbeelden

Zie de Exclude(RectangleF) en Complement(Region) methoden voor codevoorbeelden.

Van toepassing op

Exclude(GraphicsPath)

Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven GraphicsPathintersect.

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)

Parameters

path
GraphicsPath

De GraphicsPath om uit te sluiten van dit Region.

Uitzonderingen

ArgumentNullException

path is null.

Voorbeelden

In het volgende codevoorbeeld ziet u de Region constructor en de Exclude methoden.Dispose

Dit voorbeeld is ontworpen voor gebruik met Windows Forms. Plak de code in een formulier en roep de methode aan bij het FillRegionExcludingPath verwerken van de gebeurtenis van Paint het formulier, waarbij deze wordt doorgegeven e als PaintEventArgs.

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

Van toepassing op

Exclude(Rectangle)

Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven Rectangle structuur kruist.

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)

Parameters

rect
Rectangle

De Rectangle structuur die hiervan moet Regionworden uitgesloten.

Voorbeelden

Zie de Exclude(RectangleF) methode voor een codevoorbeeld.

Van toepassing op

Exclude(RectangleF)

Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven RectangleF structuur kruist.

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)

Parameters

rect
RectangleF

De RectangleF structuur die hiervan moet Regionworden uitgesloten.

Voorbeelden

Het volgende voorbeeld is ontworpen voor gebruik met Windows Forms en vereist PaintEventArgse, een parameter van de Paint gebeurtenis-handler. De code voert de volgende acties uit:

  • Hiermee maakt u een rechthoek en tekent u deze op het scherm in zwart

  • Hiermee maakt u een tweede rechthoek die met de eerste kruist en deze in rood naar het scherm tekent.

  • Hiermee maakt u een regio met behulp van de eerste rechthoek.

  • Hiermee wordt het niet-uitgesloten gebied van de regio opgehaald in combinatie met de tweede rechthoek.

  • Vult het niet-uitgesloten gebied met blauw en tekent het op het scherm.

U ziet dat het gebied van het gebied van het gebied dat niet met de rechthoek kruist blauw is.

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

Van toepassing op