Graphics.SetClip Graphics.SetClip Graphics.SetClip Graphics.SetClip Method

定義

この Graphics のクリッピング領域を指定した GraphicsClip プロパティに設定します。Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

オーバーロード

SetClip(Region, CombineMode) SetClip(Region, CombineMode) SetClip(Region, CombineMode)

この Graphics のクリッピング領域を、現在のクリップ領域と指定した Region とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode)

この Graphics のクリッピング領域を現在のクリップ領域と RectangleF 構造体で指定された四角形とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a RectangleF structure.

SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode)

この Graphics のクリッピング領域を現在のクリップ領域と Rectangle 構造体で指定された四角形とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode)

この Graphics のクリッピング領域を、現在のクリップ領域と指定した GraphicsPath とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified GraphicsPath.

SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode)

この Graphics のクリッピング領域を、現在のクリップ領域と指定した ClipGraphics プロパティとを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified combining operation of the current clip region and the Clip property of the specified Graphics.

SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle)

この Graphics のクリッピング領域を Rectangle 構造体で指定された四角形に設定します。Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

SetClip(Graphics) SetClip(Graphics) SetClip(Graphics) SetClip(Graphics)

この Graphics のクリッピング領域を指定した GraphicsClip プロパティに設定します。Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath)

この Graphics のクリッピング領域を指定した GraphicsPath オブジェクトに設定します。Sets the clipping region of this Graphics to the specified GraphicsPath.

SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF)

この Graphics のクリッピング領域を RectangleF 構造体で指定された四角形に設定します。Sets the clipping region of this Graphics to the rectangle specified by a RectangleF structure.

SetClip(Region, CombineMode) SetClip(Region, CombineMode) SetClip(Region, CombineMode)

この Graphics のクリッピング領域を、現在のクリップ領域と指定した Region とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified 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

パラメーター

region
Region Region Region Region

組み合わせる RegionRegion to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

使用する組み合わせ操作を指定する CombineMode 列挙体のメンバー。Member from the CombineMode enumeration that specifies the combining operation to use.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • クリッピング領域に小さな四角形を作成します。Creates a small rectangle for the clipping region.

  • クリッピング領域を含む四角形に設定、Replaceメンバー。Sets the clipping region to the rectangle with the Replace member.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒、塗りつぶされた小さな四角形になります。The result is a small, filled, black rectangle.

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) SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode)

この Graphics のクリッピング領域を現在のクリップ領域と RectangleF 構造体で指定された四角形とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a RectangleF structure.

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

パラメーター

rect
RectangleF RectangleF RectangleF RectangleF

組み合わせる RectangleF 構造体。RectangleF structure to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

使用する組み合わせ操作を指定する CombineMode 列挙体のメンバー。Member of the CombineMode enumeration that specifies the combining operation to use.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • クリッピング領域に小さな四角形を作成します。Creates a small rectangle for the clipping region.

  • クリッピング領域を含む四角形に設定、Replaceメンバー。Sets the clipping region to the rectangle with the Replace member.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒、塗りつぶされた小さな四角形になります。The result is a small, filled, black rectangle.

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) SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode)

この Graphics のクリッピング領域を現在のクリップ領域と Rectangle 構造体で指定された四角形とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

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

パラメーター

rect
Rectangle Rectangle Rectangle Rectangle

組み合わせる Rectangle 構造体。Rectangle structure to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

使用する組み合わせ操作を指定する CombineMode 列挙体のメンバー。Member of the CombineMode enumeration that specifies the combining operation to use.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • クリッピング領域に小さな四角形を作成します。Creates a small rectangle for the clipping region.

  • クリッピング領域を含む四角形に設定、Replaceメンバー。Sets the clipping region to the rectangle with the Replace member.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒、塗りつぶされた小さな四角形になります。The result is a small, filled, black rectangle.

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(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode)

この Graphics のクリッピング領域を、現在のクリップ領域と指定した GraphicsPath とを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified 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

パラメーター

combineMode
CombineMode CombineMode CombineMode CombineMode

使用する組み合わせ操作を指定する CombineMode 列挙体のメンバー。Member of the CombineMode enumeration that specifies the combining operation to use.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • グラフィックス パスを作成し、パスに楕円を追加します。Creates a graphics path and adds an ellipse to the path.

  • 楕円のモーション パスにクリッピング領域を設定、Replaceメンバー。Sets the clipping region to the elliptical path with the Replace member.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒で塗りつぶされた楕円になります。The result is a filled, black ellipse.

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パラメーターが閉じられていない追加の線分が最後のポイントからパスを閉じるには、最初のポイントを追加します。If the graphics path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.

SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode)

この Graphics のクリッピング領域を、現在のクリップ領域と指定した ClipGraphics プロパティとを組み合わせる指定の操作の結果に設定します。Sets the clipping region of this Graphics to the result of the specified combining operation of the current clip region and the Clip property of the specified Graphics.

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

パラメーター

g
Graphics Graphics Graphics Graphics

組み合わせるクリップ領域を指定する GraphicsGraphics that specifies the clip region to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

使用する組み合わせ操作を指定する CombineMode 列挙体のメンバー。Member of the CombineMode enumeration that specifies the combining operation to use.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、PaintイベントのハンドラーだけでなくthisFormFormの例では、します。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler, as well as thisForm, the Form for the example. コードは、次のアクションを実行します。The code performs the following actions:

  • 一時テーブルが作成Graphicsから、 thisForm Formの例では、します。Creates a temporary Graphics from the thisFormForm of the example.

  • 一時のクリッピング領域を設定Graphics小さな正方形にします。Sets the clipping region of the temporary Graphics to a small square.

  • 新しいフォームのグラフィック オブジェクトのクリッピング領域を更新Graphicsで、Replaceメンバー。Updates the clipping region of the form's graphic object to that of the new Graphics with the Replace member.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒小規模で塗りつぶされた四角形になります。The result is a small, filled, black square.

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(Rectangle) SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle)

この Graphics のクリッピング領域を Rectangle 構造体で指定された四角形に設定します。Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

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 Rectangle Rectangle

新しいクリップ領域を表す Rectangle 構造体。Rectangle structure that represents the new clip region.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • クリッピング領域に小さな四角形を作成します。Creates a small rectangle for the clipping region.

  • クリッピング領域を四角形に設定します。Sets the clipping region to the rectangle.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒、塗りつぶされた小さな四角形になります。The result is a small, filled, black rectangle.

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) SetClip(Graphics) SetClip(Graphics) SetClip(Graphics)

この Graphics のクリッピング領域を指定した GraphicsClip プロパティに設定します。Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

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 Graphics Graphics

新しいクリップ領域の取得元となる GraphicsGraphics from which to take the new clip region.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、PaintイベントのハンドラーだけでなくthisFormFormの例では、します。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler, as well as thisForm, the Form for the example. コードは、次のアクションを実行します。The code performs the following actions:

  • 一時テーブルが作成Graphicsから、 thisForm Formの例では、します。Creates a temporary Graphics from the thisFormForm of the example.

  • 一時のクリッピング領域を設定Graphics小さな正方形にします。Sets the clipping region of the temporary Graphics to a small square.

  • 一時のフォームのグラフィック オブジェクトのクリッピング領域を更新Graphicsします。Updates the clipping region of the form's graphic object to that of the temporary Graphics.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒小規模で塗りつぶされた四角形になります。The result is a small, filled, black square.

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) SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath)

この Graphics のクリッピング領域を指定した GraphicsPath オブジェクトに設定します。Sets the clipping region of this Graphics to the specified 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 GraphicsPath GraphicsPath

新しいクリップ領域を表す GraphicsPathGraphicsPath that represents the new clip region.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • グラフィックス パスを作成し、パスに楕円を追加します。Creates a graphics path and adds an ellipse to the path.

  • クリッピング領域を楕円のモーション パスに設定します。Sets the clipping region to the elliptical path.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒で塗りつぶされた楕円になります。The result is a filled, black ellipse.

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パラメーターが閉じられていない追加の線分が最後のポイントからパスを閉じるには、最初のポイントを追加します。If the graphics path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.

SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF)

この Graphics のクリッピング領域を RectangleF 構造体で指定された四角形に設定します。Sets the clipping region of this Graphics to the rectangle specified by a RectangleF structure.

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 RectangleF RectangleF

新しいクリップ領域を表す RectangleF 構造体。RectangleF structure that represents the new clip region.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • クリッピング領域に小さな四角形を作成します。Creates a small rectangle for the clipping region.

  • クリッピング領域を四角形に設定します。Sets the clipping region to the rectangle.

  • 黒いソリッド ブラシでは、大きな四角形を塗りつぶします。Fills a large rectangle with a solid black brush.

黒、塗りつぶされた小さな四角形になります。The result is a small, filled, black rectangle.

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

適用対象