Graphics.SetClip 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

将此 Graphics 的剪辑区域设置为指定 Graphics 的 Clip 属性。

重载

SetClip(Region, CombineMode)	将此 Graphics 的剪辑区域设置为当前剪辑区域与指定 Region 的组合结果。
SetClip(RectangleF, CombineMode)	将此 Graphics 的剪辑区域设置为当前剪辑区域与 RectangleF 结构所指定矩形的组合结果。
SetClip(Rectangle, CombineMode)	将此 Graphics 的剪辑区域设置为当前剪辑区域与 Rectangle 结构所指定矩形的组合结果。
SetClip(Graphics, CombineMode)	将此 Graphics 的剪辑区域设置为当前剪辑区域和指定的 Graphics 的 Clip 属性指定的组合操作的结果。
SetClip(RectangleF)	将此 Graphics 的剪辑区域设置为 RectangleF 结构指定的矩形。
SetClip(Rectangle)	将此 Graphics 的剪辑区域设置为 Rectangle 结构指定的矩形。
SetClip(Graphics)	将此 Graphics 的剪辑区域设置为指定 Graphics 的 Clip 属性。
SetClip(GraphicsPath)	将此 Graphics 的剪辑区域设置为指定的 GraphicsPath。
SetClip(GraphicsPath, CombineMode)	将此 Graphics 的剪辑区域设置为当前剪辑区域与指定 GraphicsPath 的组合结果。

SetClip(Region, CombineMode)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为当前剪辑区域与指定 Region 的组合结果。

public:
 void SetClip(System::Drawing::Region ^ region, System::Drawing::Drawing2D::CombineMode combineMode);

public void SetClip (System.Drawing.Region region, System.Drawing.Drawing2D.CombineMode combineMode);

member this.SetClip : System.Drawing.Region * System.Drawing.Drawing2D.CombineMode -> unit

Public Sub SetClip (region As Region, combineMode As CombineMode)

参数

region

Region

要组合的 Region。

combineMode

CombineMode

CombineMode 枚举的成员，它指定要使用的组合操作。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 为剪裁区域创建一个小矩形。

• 将剪裁区域设置为具有 成员的 Replace 矩形。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色小矩形。

public:
   void SetClipRegionCombine( PaintEventArgs^ e )
   {
      // Create region for clipping.
      System::Drawing::Region^ clipRegion = gcnew System::Drawing::Region( Rectangle(0,0,100,100) );

      // Set clipping region of graphics to region.
      e->Graphics->SetClip( clipRegion, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipRegionCombine(PaintEventArgs e)
{

    // Create region for clipping.
    Region clipRegion = new Region(new Rectangle(0, 0, 100, 100));

    // Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipRegionCombine(ByVal e As PaintEventArgs)

    ' Create region for clipping.
    Dim clipRegion As New [Region](New Rectangle(0, 0, 100, 100))

    ' Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(RectangleF, CombineMode)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为当前剪辑区域与 RectangleF 结构所指定矩形的组合结果。

public:
 void SetClip(System::Drawing::RectangleF rect, System::Drawing::Drawing2D::CombineMode combineMode);

public void SetClip (System.Drawing.RectangleF rect, System.Drawing.Drawing2D.CombineMode combineMode);

member this.SetClip : System.Drawing.RectangleF * System.Drawing.Drawing2D.CombineMode -> unit

Public Sub SetClip (rect As RectangleF, combineMode As CombineMode)

参数

rect

RectangleF

要组合的 RectangleF 结构。

combineMode

CombineMode

CombineMode 枚举的成员，它指定要使用的组合操作。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 为剪裁区域创建一个小矩形。

• 将剪裁区域设置为具有 成员的 Replace 矩形。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色小矩形。

public:
   void SetClipRectangleFCombine( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipRectangleFCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipRectangleFCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Rectangle, CombineMode)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为当前剪辑区域与 Rectangle 结构所指定矩形的组合结果。

public:
 void SetClip(System::Drawing::Rectangle rect, System::Drawing::Drawing2D::CombineMode combineMode);

public void SetClip (System.Drawing.Rectangle rect, System.Drawing.Drawing2D.CombineMode combineMode);

member this.SetClip : System.Drawing.Rectangle * System.Drawing.Drawing2D.CombineMode -> unit

Public Sub SetClip (rect As Rectangle, combineMode As CombineMode)

参数

rect

Rectangle

要组合的 Rectangle 结构。

combineMode

CombineMode

CombineMode 枚举的成员，它指定要使用的组合操作。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 为剪裁区域创建一个小矩形。

• 将剪裁区域设置为具有 成员的 Replace 矩形。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色小矩形。

public:
   void SetClipRectangleCombine( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipRectangleCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipRectangleCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Graphics, CombineMode)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为当前剪辑区域和指定的 Graphics 的 Clip 属性指定的组合操作的结果。

public:
 void SetClip(System::Drawing::Graphics ^ g, System::Drawing::Drawing2D::CombineMode combineMode);

public void SetClip (System.Drawing.Graphics g, System.Drawing.Drawing2D.CombineMode combineMode);

member this.SetClip : System.Drawing.Graphics * System.Drawing.Drawing2D.CombineMode -> unit

Public Sub SetClip (g As Graphics, combineMode As CombineMode)

参数

g

Graphics

Graphics，它指定要组合的剪辑区域。

combineMode

CombineMode

CombineMode 枚举的成员，它指定要使用的组合操作。

示例

下面的代码示例设计为与 Windows 窗体 一起使用，它需要 PaintEventArgse（事件处理程序的参数Paint）和 thisForm（Form本示例的 ） 。 此代码执行以下操作：

• 从thisFormForm示例的 创建临时 Graphics 。

• 将临时 Graphics 的剪裁区域设置为一个小正方形。

• 汇报窗体图形对象的剪裁区域与带有 Replace 成员的新 Graphics 的剪裁区域。

• 用纯黑色画笔填充大矩形。

结果是一个小的填充的黑色正方形。

public:
   void SetClipGraphicsCombine( PaintEventArgs^ e )
   {
      // Create temporary graphics object and set its clipping region.
      Graphics^ newGraphics = this->CreateGraphics();
      newGraphics->SetClip( Rectangle(0,0,100,100) );

      // Update clipping region of graphics to clipping region of new
      // graphics.
      e->Graphics->SetClip( newGraphics, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

      // Release new graphics.
      delete newGraphics;
   }

private void SetClipGraphicsCombine(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}

Private Sub SetClipGraphicsCombine(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.CreateGraphics()
    newGraphics.SetClip(New Rectangle(0, 0, 100, 100))

    ' Update clipping region of graphics to clipping region of new

    ' graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)

    ' Release new graphics.
    newGraphics.Dispose()
End Sub

SetClip(RectangleF)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为 RectangleF 结构指定的矩形。

public:
 void SetClip(System::Drawing::RectangleF rect);

public void SetClip (System.Drawing.RectangleF rect);

member this.SetClip : System.Drawing.RectangleF -> unit

Public Sub SetClip (rect As RectangleF)

参数

rect

RectangleF

RectangleF 结构，它表示新的剪辑区域。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 为剪裁区域创建一个小矩形。

• 将剪裁区域设置为矩形。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色小矩形。

public:
   void SetClipRectangleF( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipRectangleF(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipRectangleF(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Rectangle)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为 Rectangle 结构指定的矩形。

public:
 void SetClip(System::Drawing::Rectangle rect);

public void SetClip (System.Drawing.Rectangle rect);

member this.SetClip : System.Drawing.Rectangle -> unit

Public Sub SetClip (rect As Rectangle)

参数

rect

Rectangle

Rectangle 结构，它表示新的剪辑区域。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 为剪裁区域创建一个小矩形。

• 将剪裁区域设置为矩形。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色小矩形。

public:
   void SetClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipRectangle(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Graphics)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为指定 Graphics 的 Clip 属性。

public:
 void SetClip(System::Drawing::Graphics ^ g);

public void SetClip (System.Drawing.Graphics g);

member this.SetClip : System.Drawing.Graphics -> unit

Public Sub SetClip (g As Graphics)

参数

g

Graphics

Graphics，从该对象中获取新剪辑区域。

示例

下面的代码示例设计为与 Windows 窗体 一起使用，它需要 PaintEventArgse（事件处理程序的参数Paint）和 thisForm（Form本示例的 ） 。 此代码执行以下操作：

• 从thisFormForm示例的 创建临时 Graphics 。

• 将临时 Graphics 的剪裁区域设置为一个小正方形。

• 汇报窗体的图形对象的剪裁区域与临时 Graphics的剪裁区域。

• 用纯黑色画笔填充大矩形。

结果是一个小的填充的黑色正方形。

public:
   void SetClipGraphics( PaintEventArgs^ e )
   {
      // Create temporary graphics object and set its clipping region.
      Graphics^ newGraphics = this->CreateGraphics();
      newGraphics->SetClip( Rectangle(0,0,100,100) );

      // Update clipping region of graphics to clipping region of new
      // graphics.
      e->Graphics->SetClip( newGraphics );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

      // Release new graphics.
      delete newGraphics;
   }

private void SetClipGraphics(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}

Private Sub SetClipGraphics(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.CreateGraphics()
    newGraphics.SetClip(New Rectangle(0, 0, 100, 100))

    ' Update clipping region of graphics to clipping region of new

    ' graphics.
    e.Graphics.SetClip(newGraphics)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)

    ' Release new graphics.
    newGraphics.Dispose()
End Sub

SetClip(GraphicsPath)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为指定的 GraphicsPath。

public:
 void SetClip(System::Drawing::Drawing2D::GraphicsPath ^ path);

public void SetClip (System.Drawing.Drawing2D.GraphicsPath path);

member this.SetClip : System.Drawing.Drawing2D.GraphicsPath -> unit

Public Sub SetClip (path As GraphicsPath)

参数

path

GraphicsPath

GraphicsPath，它表示新的剪辑区域。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 创建一个图形路径，并向该路径添加一个椭圆。

• 将剪切区域设置为椭圆路径。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色椭圆。

public:
   void SetClipPath( PaintEventArgs^ e )
   {
      // Create graphics path.
      GraphicsPath^ clipPath = gcnew GraphicsPath;
      clipPath->AddEllipse( 0, 0, 200, 100 );

      // Set clipping region to path.
      e->Graphics->SetClip( clipPath );

      // Fill rectangle to demonstrate clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipPath(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipPath(ByVal e As PaintEventArgs)

    ' Create graphics path.
    Dim clipPath As New GraphicsPath
    clipPath.AddEllipse(0, 0, 200, 100)

    ' Set clipping region to path.
    e.Graphics.SetClip(clipPath)

    ' Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

注解

如果参数表示 path 的图形路径未关闭，则从最后一个点到第一个点添加一个额外的段以关闭路径。

SetClip(GraphicsPath, CombineMode)

Source:

Graphics.cs

将此 Graphics 的剪辑区域设置为当前剪辑区域与指定 GraphicsPath 的组合结果。

public:
 void SetClip(System::Drawing::Drawing2D::GraphicsPath ^ path, System::Drawing::Drawing2D::CombineMode combineMode);

public void SetClip (System.Drawing.Drawing2D.GraphicsPath path, System.Drawing.Drawing2D.CombineMode combineMode);

member this.SetClip : System.Drawing.Drawing2D.GraphicsPath * System.Drawing.Drawing2D.CombineMode -> unit

Public Sub SetClip (path As GraphicsPath, combineMode As CombineMode)

参数

path

GraphicsPath

要组合的 GraphicsPath。

combineMode

CombineMode

CombineMode 枚举的成员，它指定要使用的组合操作。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 创建一个图形路径，并向该路径添加一个椭圆。

• 将剪辑区域设置为具有 成员的 Replace 椭圆路径。

• 用纯黑色画笔填充大矩形。

结果是一个填充的黑色椭圆。

public:
   void SetClipPathCombine( PaintEventArgs^ e )
   {
      // Create graphics path.
      GraphicsPath^ clipPath = gcnew GraphicsPath;
      clipPath->AddEllipse( 0, 0, 200, 100 );

      // Set clipping region to path.
      e->Graphics->SetClip( clipPath, CombineMode::Replace );

      // Fill rectangle to demonstrate clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void SetClipPathCombine(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Private Sub SetClipPathCombine(ByVal e As PaintEventArgs)

    ' Create graphics path.
    Dim clipPath As New GraphicsPath
    clipPath.AddEllipse(0, 0, 200, 100)

    ' Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace)

    ' Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

注解

如果 参数表示的 path 图形路径未关闭，则会从最后一个点添加到第一个点的另一个段以关闭路径。