Graphics.ExcludeClip メソッド

  • リファレンス

定義

名前空間:
System.Drawing
アセンブリ:
System.Drawing.Common.dll
アセンブリ:
System.Drawing.dll
パッケージ:
System.Drawing.Common v8.0.10
パッケージ:
System.Drawing.Common v9.0.0-rc.2.24474.1

この Graphics のクリップ領域を更新して、Rectangle 構造体で指定された領域を除外します。

オーバーロード

ExcludeClip(Region)

この Graphics のクリップ領域を更新して、Regionで指定された領域を除外します。
ExcludeClip(Rectangle)

この Graphics のクリップ領域を更新して、Rectangle 構造体で指定された領域を除外します。

ExcludeClip(Region)

ソース:
Graphics.cs
ソース:
Graphics.cs

この Graphics のクリップ領域を更新して、Regionで指定された領域を除外します。

public:
 void ExcludeClip(System::Drawing::Region ^ region);
public void ExcludeClip (System.Drawing.Region region);
member this.ExcludeClip : System.Drawing.Region -> unit
Public Sub ExcludeClip (region As Region)

パラメーター

region
Region

クリップ領域から除外する領域を指定する Region。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコードは、次のアクションを実行します。

  • 左上隅が座標 (100,100) にある 100 ピクセル x 100 ピクセルの四角形を作成します。

  • 四角形を除外する領域を設定します。

  • 左上隅が座標 (0, 0) にある 300 ピクセル x 300 ピクセルの四角形を青の純色ブラシで塗りつぶします。

結果は、右下隅に向かって四角形が見つからない青い四角形になります。

public:
   void ExcludeClipRegion( PaintEventArgs^ e )
   {
      // Create rectangle for region.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Create region for exclusion.
      System::Drawing::Region^ excludeRegion = gcnew System::Drawing::Region( excludeRect );

      // Set clipping region to exclude region.
      e->Graphics->ExcludeClip( excludeRegion );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

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

Public Sub ExcludeClipRegion(ByVal e As PaintEventArgs)

    ' Create rectangle for region.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Create region for exclusion.
    Dim excludeRegion As 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)
End Sub

注釈

このメソッドは、現在のクリップ領域から region パラメーターで指定された領域を除外し、結果の領域をこの Graphicsの Clip プロパティに割り当てます。

適用対象

ExcludeClip(Rectangle)

ソース:
Graphics.cs
ソース:
Graphics.cs

この Graphics のクリップ領域を更新して、Rectangle 構造体で指定された領域を除外します。

public:
 void ExcludeClip(System::Drawing::Rectangle rect);
public void ExcludeClip (System.Drawing.Rectangle rect);
member this.ExcludeClip : System.Drawing.Rectangle -> unit
Public Sub ExcludeClip (rect As Rectangle)

パラメーター

rect
Rectangle

Rectangle クリップ領域から除外する四角形を指定する構造体です。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコードは、次のアクションを実行します。

  • 左上隅が座標 (100,100) にある 100 ピクセル x 100 ピクセルの四角形を作成します。

  • 四角形で定義された領域を作成します。

  • 四角形領域を除外するクリッピング領域を設定します。

  • 左上隅が座標 (0, 0) にある 300 ピクセル x 300 ピクセルの四角形を青の純色ブラシで塗りつぶします。

結果は、右下隅に四角形の領域が見つからない青い四角形になります。

public:
   void ExcludeClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for exclusion.
      Rectangle excludeRect = 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( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

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

Public Sub ExcludeClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for exclusion.
    Dim excludeRect As 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)
End Sub

注釈

このメソッドは、現在のクリップ領域から rect パラメーターで指定された領域を除外し、結果の領域をこの Graphicsの Clip プロパティに割り当てます。

適用対象