Region.Exclude 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

將這個 Region 更新為其內部中不與指定之 Rectangle 結構交集的部分。

多載

Exclude(Region)	更新這個 Region，以便只包含其內部中不與指定之 Region 交集的部分。
Exclude(GraphicsPath)	更新這個 Region，以便只包含其內部中不與指定之 GraphicsPath 交集的部分。
Exclude(Rectangle)	更新這個 Region 物件，以便只包含其內部中不與指定之 Rectangle 結構交集的部分。
Exclude(RectangleF)	更新這個 Region 物件，以便只包含其內部中不與指定之 RectangleF 結構交集的部分。

Exclude(Region)

來源:

Region.cs

更新這個 Region，以便只包含其內部中不與指定之 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)

參數

region

Region

要從這個 Region 排除的 Region。

例外狀況

ArgumentNullException

region 為 null。

範例

如需程式代碼範例，請參閱 Exclude(RectangleF) 和 Complement(Region) 方法。

Exclude(GraphicsPath)

來源:

Region.cs

更新這個 Region，以便只包含其內部中不與指定之 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)

參數

path

GraphicsPath

要從這個 GraphicsPath 排除的 Region。

例外狀況

ArgumentNullException

path 為 null。

範例

下列程式代碼範例示範建 Region 構函式和 Exclude 和 Dispose 方法。

此範例的設計目的是要與 Windows Forms 搭配使用。 將程式代碼貼到表單中，並在處理表單的事件Paint時呼叫 FillRegionExcludingPath 方法，並傳遞e為 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)

來源:

Region.cs

更新這個 Region 物件，以便只包含其內部中不與指定之 Rectangle 結構交集的部分。

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)

參數

rect

Rectangle

要從這個 Rectangle 排除的 Region 結構。

範例

如需程式代碼範例，請參閱 Exclude(RectangleF) 方法。

Exclude(RectangleF)

來源:

Region.cs

更新這個 Region 物件，以便只包含其內部中不與指定之 RectangleF 結構交集的部分。

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)

參數

rect

RectangleF

要從這個 RectangleF 排除的 Region 結構。

範例

下列範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 此程式碼會執行下列動作：

• 建立矩形並將它繪製到黑色的畫面

• 建立與第一個相交的第二個矩形，並以紅色將它繪製到畫面。

• 使用第一個矩形建立區域。

• 當與第二個矩形結合時，取得區域的非排除區域。

• 以藍色填滿非排除的區域，並將它繪製到畫面上。

請注意，未與矩形交集的區域區域會以藍色顯示。

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