Region.Exclude Metod

Definition

Namnområde:: System.Drawing

Sammansättning:: System.Drawing.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Uppdaterar detta Region till den del av dess inre som inte korsar den angivna Rectangle strukturen.

Överlagringar

Name	Description
Exclude(Region)	Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna Region.
Exclude(GraphicsPath)	Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna GraphicsPath.
Exclude(Rectangle)	Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna Rectangle strukturen.
Exclude(RectangleF)	Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna RectangleF strukturen.

Exclude(Region)

Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna Region.

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)

Parametrar

region: Region

Att Region exkludera från detta Region.

Undantag

ArgumentNullException

region är null.

Exempel

Kodexempel finns i Exclude(RectangleF) metoderna och Complement(Region) .

Gäller för

Exclude(GraphicsPath)

Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna GraphicsPath.

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)

Parametrar

path: GraphicsPath

Att GraphicsPath exkludera från detta Region.

Undantag

ArgumentNullException

path är null.

Exempel

I följande kodexempel visas Region konstruktorn och Exclude metoderna och Dispose .

Det här exemplet är utformat för att användas med Windows Forms. Klistra in koden i ett formulär och anropa FillRegionExcludingPath metoden när du hanterar formulärets Paint händelse och skicka e som 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

Gäller för

Exclude(Rectangle)

Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna Rectangle strukturen.

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)

Parametrar

rect: Rectangle

Den Rectangle struktur som ska undantas från den här Region.

Exempel

Ett kodexempel finns i Exclude(RectangleF) metoden.

Gäller för

Exclude(RectangleF)

Uppdaterar detta Region så att det endast innehåller den del av dess inre som inte korsar den angivna RectangleF strukturen.

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)

Parametrar

rect: RectangleF

Den RectangleF struktur som ska undantas från den här Region.

Exempel

Följande exempel är utformat för användning med Windows Forms och kräver PaintEventArgse, vilket är en parameter för händelsehanteraren Paint. Koden utför följande åtgärder:

Skapar en rektangel och drar den till skärmen i svart
Skapar en andra rektangel som korsar med den första och drar den till skärmen i rött.
Skapar en region med hjälp av den första rektangeln.
Hämtar det noxcluded området i regionen när det kombineras med den andra rektangeln.
Fyller det noxcluded området med blått och drar det till skärmen.

Observera att området i regionen som inte korsar rektangeln är färgat blått.

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

Gäller för

Feedback

Var den här sidan till hjälp?