Graphics.SetClip 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

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

将此 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(GraphicsPath, CombineMode)	将此 Graphics 的剪辑区域设置为组合当前剪辑区域和指定 GraphicsPath的指定操作的结果。
SetClip(RectangleF)	将此 Graphics 的剪辑区域设置为由 RectangleF 结构指定的矩形。
SetClip(Rectangle)	将此 Graphics 的剪辑区域设置为由 Rectangle 结构指定的矩形。
SetClip(Graphics)	将此 Graphics 的剪辑区域设置为指定 Graphics的 Clip 属性。
SetClip(GraphicsPath)	将此 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(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 参数表示的图形路径，则从最后一个点添加到第一个点以关闭路径的其他段。

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 参数表示的图形路径，则从最后一个点添加到第一个点以关闭路径的其他段。