Region.Exclude Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

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

Perbarui Region ini ke bagian interiornya yang tidak bersinggungan dengan struktur Rectangle yang ditentukan.

Overload

Exclude(Region)	Perbarui Region ini hanya berisi bagian interiornya yang tidak bersinggungan dengan Regionyang ditentukan.
Exclude(GraphicsPath)	Perbarui Region ini hanya berisi bagian interiornya yang tidak bersinggungan dengan GraphicsPathyang ditentukan.
Exclude(Rectangle)	Perbarui Region ini agar hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur Rectangle yang ditentukan.
Exclude(RectangleF)	Perbarui Region ini agar hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur RectangleF yang ditentukan.

Exclude(Region)

Sumber:

Region.cs

Perbarui Region ini hanya berisi bagian interiornya yang tidak bersinggungan dengan Regionyang ditentukan.

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

Region untuk dikecualikan dari Regionini .

Pengecualian

ArgumentNullException

region null.

Contoh

Untuk contoh kode, lihat metode Exclude(RectangleF) dan Complement(Region).

Exclude(GraphicsPath)

Sumber:

Region.cs

Perbarui Region ini hanya berisi bagian interiornya yang tidak bersinggungan dengan GraphicsPathyang ditentukan.

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

GraphicsPath untuk dikecualikan dari Regionini .

Pengecualian

ArgumentNullException

path null.

Contoh

Contoh kode berikut menunjukkan konstruktor Region dan metode Exclude dan Dispose.

Contoh ini dirancang untuk digunakan dengan Windows Forms. Tempelkan kode ke dalam formulir dan panggil metode FillRegionExcludingPath saat menangani peristiwa Paint formulir, meneruskan e sebagai 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)

Sumber:

Region.cs

Perbarui Region ini agar hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur Rectangle yang ditentukan.

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

Struktur Rectangle untuk dikecualikan dari Regionini.

Contoh

Untuk contoh kode, lihat metode Exclude(RectangleF).

Exclude(RectangleF)

Sumber:

Region.cs

Perbarui Region ini agar hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur RectangleF yang ditentukan.

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

Struktur RectangleF untuk dikecualikan dari Regionini.

Contoh

Contoh berikut dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:

• Membuat persegi panjang dan menggambarnya ke layar dengan warna hitam

• Membuat persegi panjang kedua yang bersinggungan dengan yang pertama dan menggambarnya ke layar dengan warna merah.

• Membuat wilayah menggunakan persegi panjang pertama.

• Mendapatkan area wilayah yang tidak ada jika dikombinasikan dengan persegi panjang kedua.

• Mengisi area yang tidak ada dengan warna biru dan menggambarnya ke layar.

Perhatikan bahwa area wilayah yang tidak bersinggungan dengan persegi panjang berwarna biru.

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