Graphics.SetClip 方法

定義

將這個 Graphics 的裁剪區域設定為指定之 GraphicsClip 屬性。

多載

SetClip(Region, CombineMode)

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和指定之 Region之指定作業的結果。

SetClip(RectangleF, CombineMode)

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和 RectangleF 結構所指定矩形之指定作業的結果。

SetClip(Rectangle, CombineMode)

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和 Rectangle 結構所指定矩形之指定作業的結果。

SetClip(Graphics, CombineMode)

將這個 Graphics 的裁剪區域設定為目前剪輯區域的指定合併作業結果,以及指定之 GraphicsClip 屬性。

SetClip(GraphicsPath, CombineMode)

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和指定之 GraphicsPath之指定作業的結果。

SetClip(RectangleF)

將這個 Graphics 的裁剪區域設定為 RectangleF 結構所指定的矩形。

SetClip(Rectangle)

將這個 Graphics 的裁剪區域設定為 Rectangle 結構所指定的矩形。

SetClip(Graphics)

將這個 Graphics 的裁剪區域設定為指定之 GraphicsClip 屬性。

SetClip(GraphicsPath)

將這個 Graphics 的裁剪區域設定為指定的 GraphicsPath

SetClip(Region, CombineMode)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和指定之 Region之指定作業的結果。

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

參數

region
Region

要合併 Region

combineMode
CombineMode

指定要使用的合併作業之 CombineMode 列舉的成員。

範例

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

  • 建立裁剪區域的小型矩形。

  • 將裁剪區域設定為具有 Replace 成員的矩形。

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的矩形。

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);
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(RectangleF, CombineMode)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和 RectangleF 結構所指定矩形之指定作業的結果。

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

參數

rect
RectangleF

要合併 RectangleF 結構。

combineMode
CombineMode

指定要使用的合併作業之 CombineMode 列舉的成員。

範例

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

  • 建立裁剪區域的小型矩形。

  • 將裁剪區域設定為具有 Replace 成員的矩形。

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的矩形。

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);
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(Rectangle, CombineMode)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和 Rectangle 結構所指定矩形之指定作業的結果。

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

參數

rect
Rectangle

要合併 Rectangle 結構。

combineMode
CombineMode

指定要使用的合併作業之 CombineMode 列舉的成員。

範例

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

  • 建立裁剪區域的小型矩形。

  • 將裁剪區域設定為具有 Replace 成員的矩形。

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的矩形。

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);
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(Graphics, CombineMode)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為目前剪輯區域的指定合併作業結果,以及指定之 GraphicsClip 屬性。

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

參數

g
Graphics

Graphics,指定要合併的剪輯區域。

combineMode
CombineMode

指定要使用的合併作業之 CombineMode 列舉的成員。

範例

下列程式代碼範例的設計目的是要與 Windows Forms 搭配使用,而且它需要 PaintEventArgse,這是 Paint 事件處理程式的參數,以及 thisForm,此範例 Form。 程式代碼會執行下列動作:

  • 從範例的 thisFormForm 建立暫時 Graphics

  • 將暫存 Graphics 的裁剪區域設定為小型方形。

  • 使用 Replace 成員,將窗體圖形物件的裁剪區域更新為新 Graphics

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的方形。

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();
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(GraphicsPath, CombineMode)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為結合目前剪輯區域和指定之 GraphicsPath之指定作業的結果。

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

參數

path
GraphicsPath

要合併 GraphicsPath

combineMode
CombineMode

指定要使用的合併作業之 CombineMode 列舉的成員。

範例

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

  • 建立圖形路徑,並將省略號新增至路徑。

  • 使用 Replace 成員,將裁剪區域設定為橢圓形路徑。

  • 以實心黑色筆刷填滿大型矩形。

結果是填滿的黑色橢圓形。

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);
}

備註

如果未關閉 path 參數所代表的圖形路徑,則會從最後一個點新增至第一個點以關閉路徑的其他區段。

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(RectangleF)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為 RectangleF 結構所指定的矩形。

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

參數

rect
RectangleF

RectangleF 結構,表示新的剪輯區域。

範例

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

  • 建立裁剪區域的小型矩形。

  • 將裁剪區域設定為矩形。

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的矩形。

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);
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(Rectangle)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為 Rectangle 結構所指定的矩形。

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

參數

rect
Rectangle

Rectangle 結構,表示新的剪輯區域。

範例

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

  • 建立裁剪區域的小型矩形。

  • 將裁剪區域設定為矩形。

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的矩形。

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);
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(Graphics)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為指定之 GraphicsClip 屬性。

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

參數

g
Graphics

要從中取得新剪輯區域的 Graphics

範例

下列程式代碼範例的設計目的是要與 Windows Forms 搭配使用,而且它需要 PaintEventArgse,這是 Paint 事件處理程式的參數,以及 thisForm,此範例 Form。 程式代碼會執行下列動作:

  • 從範例的 thisFormForm 建立暫時 Graphics

  • 將暫存 Graphics 的裁剪區域設定為小型方形。

  • 將表單圖形物件的裁剪區域更新為暫時 Graphics

  • 以實心黑色筆刷填滿大型矩形。

結果是一個小型、填滿、黑色的方形。

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();
}

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetClip(GraphicsPath)

來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs
來源:
Graphics.cs

將這個 Graphics 的裁剪區域設定為指定的 GraphicsPath

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

參數

path
GraphicsPath

GraphicsPath,代表新的剪輯區域。

範例

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

  • 建立圖形路徑,並將省略號新增至路徑。

  • 將裁剪區域設定為橢圓形路徑。

  • 以實心黑色筆刷填滿大型矩形。

結果是填滿的黑色橢圓形。

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);
}

備註

如果未關閉 path 參數所代表的圖形路徑,則會從最後一個點新增至第一個點以關閉路徑的其他區段。

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9