Graphics.ExcludeClip 方法

定義

更新此 Graphics 的剪輯區域,以排除 Rectangle 結構所指定的區域。

多載

ExcludeClip(Region)

更新此 Graphics 的剪輯區域,以排除 Region所指定的區域。

ExcludeClip(Rectangle)

更新此 Graphics 的剪輯區域,以排除 Rectangle 結構所指定的區域。

ExcludeClip(Region)

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

更新此 Graphics 的剪輯區域,以排除 Region所指定的區域。

C#
public void ExcludeClip(System.Drawing.Region region);

參數

region
Region

Region,指定要從剪輯區域排除的區域。

範例

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

  • 建立 100 像素的 100 像素矩形,其左上角位於座標 (100, 100)。

  • 設定裁剪區域以排除矩形。

  • 以純藍色筆刷填滿 300 像素的 300 像素矩形,其左上角位於座標 (0, 0) 。

結果是藍色矩形,其右下角缺少正方形區域。

C#
public void ExcludeClipRegion(PaintEventArgs e)
{
             
    // Create rectangle for region.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Create region for exclusion.
    Region excludeRegion = new Region(excludeRect);
             
    // Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

備註

此方法會從目前剪輯區域排除 region 參數所指定的區域,並將產生的區域指派給這個 GraphicsClip 屬性。

適用於

.NET 10 (package-provided) 及其他版本
產品 版本
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.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 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

ExcludeClip(Rectangle)

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

更新此 Graphics 的剪輯區域,以排除 Rectangle 結構所指定的區域。

C#
public void ExcludeClip(System.Drawing.Rectangle rect);

參數

rect
Rectangle

Rectangle 結構,指定要從剪輯區域排除的矩形。

範例

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

  • 建立 100 像素的 100 像素矩形,其左上角位於座標 (100, 100)。

  • 建立矩形所定義的區域。

  • 設定裁剪區域以排除矩形區域。

  • 以純藍色筆刷填滿 300 像素的 300 像素矩形,其左上角位於座標 (0, 0) 。

結果是藍色矩形,其右下角缺少正方形區域。

C#
public void ExcludeClipRectangle(PaintEventArgs e)
{
             
    // Create rectangle for exclusion.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

備註

此方法會從目前剪輯區域排除 rect 參數所指定的區域,並將產生的區域指派給這個 GraphicsClip 屬性。

適用於

.NET 10 (package-provided) 及其他版本
產品 版本
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.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 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10