Region.Exclude Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

BunuRegion, iç kısmının belirtilen Rectangle yapıyla kesişmeyen bölümüne Güncelleştirmeler.

Aşırı Yüklemeler

Exclude(Region)	BunuRegion, iç kısmının yalnızca belirtilen Regionile kesişmeyen bölümünü içerecek şekilde Güncelleştirmeler.
Exclude(GraphicsPath)	BunuRegion, iç kısmının yalnızca belirtilen GraphicsPathile kesişmeyen bölümünü içerecek şekilde Güncelleştirmeler.
Exclude(Rectangle)	BunuRegion, iç kısmının belirtilen Rectangle yapıyla kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.
Exclude(RectangleF)	BunuRegion, iç kısmının belirtilen RectangleF yapıyla kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.

Exclude(Region)

Kaynak:

Region.cs

BunuRegion, iç kısmının yalnızca belirtilen Regionile kesişmeyen bölümünü içerecek şekilde Güncelleştirmeler.

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)

Parametreler

region

Region

bu RegionRegionöğesinin dışında tutulacak .

Özel durumlar

ArgumentNullException

region, null değeridir.

Örnekler

Kod örnekleri için ve Complement(Region) yöntemlerine Exclude(RectangleF) bakın.

Exclude(GraphicsPath)

Kaynak:

Region.cs

BunuRegion, iç kısmının yalnızca belirtilen GraphicsPathile kesişmeyen bölümünü içerecek şekilde Güncelleştirmeler.

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)

Parametreler

path

GraphicsPath

bu GraphicsPathRegionöğesinin dışında tutulacak .

Özel durumlar

ArgumentNullException

path, null değeridir.

Örnekler

Aşağıdaki kod örneği oluşturucuyu Region ve Exclude ve Dispose yöntemlerini gösterir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu bir forma yapıştırın ve formun FillRegionExcludingPathPaint olayını işlerken yöntemini çağırın e ve olarak geçirin 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

Exclude(Rectangle)

Kaynak:

Region.cs

BunuRegion, iç kısmının belirtilen Rectangle yapıyla kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.

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)

Parametreler

rect

Rectangle

Bu RectangleRegionöğesinin dışında tutulacak yapı.

Örnekler

Kod örneği için yöntemine Exclude(RectangleF) bakın.

Exclude(RectangleF)

Kaynak:

Region.cs

BunuRegion, iç kısmının belirtilen RectangleF yapıyla kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.

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)

Parametreler

rect

RectangleF

Bu RectangleFRegionöğesinin dışında tutulacak yapı.

Örnekler

Aşağıdaki örnek, Windows Forms ile kullanılmak üzere tasarlanmıştır ve olay işleyicisinin bir parametresi olan öğesini gerektirirPaintEventArgse.Paint Kod aşağıdaki eylemleri gerçekleştirir:

• Bir dikdörtgen oluşturur ve siyah olarak ekrana çizer

• İlkiyle kesişen ve kırmızıyla ekrana çizen ikinci bir dikdörtgen oluşturur.

• İlk dikdörtgeni kullanarak bir bölge oluşturur.

• İkinci dikdörtgenle birleştirildiğinde bölgenin dahil olmayan alanını alır.

• Dahil olmayan alanı mavi ile doldurur ve ekrana çizer.

Bölgenin dikdörtgenle kesişmeyen alanının mavi renkli olduğuna dikkat edin.

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