Graphics.Clip プロパティ

.NET Framework クラス ライブラリ リファレンス

Graphics.Clip プロパティ

この Graphics の描画領域を限定する Region を取得または設定します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Property Clip As
 Region

Visual Basic (使用法)

Dim instance As Graphics
Dim value As Region

value = instance.Clip

instance.Clip = value

C#

public Region Clip { get; set;
 }

C++

public:
property Region^ Clip {
    Region^ get ();
    void set (Region^ value);
}

J#

/** @property */
public Region get_Clip ()

/** @property */
public void set_Clip (Region value)

JScript

public function get Clip
 () : Region

public function set Clip
 (value : Region)

プロパティ値
この Graphics のうち、現在描画に使用できる部分を限定する Region。

解説

クリッピング領域が無限かどうかを判断するには、Clip プロパティを取得し、その IsInfinite メソッドを呼び出します。

使用例

Clip プロパティの使用方法を示すコード例を次に示します。この例は、Windows フォームでの使用を意図してデザインされています。コードをフォームに貼り付け、フォームの Paint イベントを処理するときに PaintEventArgs の e を渡して SetAndFillClip メソッドを呼び出します。

Visual Basic

Private Sub SetAndFillClip(ByVal
 e As PaintEventArgs)

    ' Set the Clip property to a new region.
    e.Graphics.Clip = New Region(New Rectangle(10,
 10, 100, 200))

    ' Fill the region.
    e.Graphics.FillRegion(Brushes.LightSalmon, e.Graphics.Clip)

    ' Demonstrate the clip region by drawing a string
    ' at the outer edge of the region.
    e.Graphics.DrawString("Outside of Clip", _
        New Font("Arial", 12.0F,
 FontStyle.Regular), _
        Brushes.Black, 0.0F, 0.0F)

End Sub

C#

private void SetAndFillClip(PaintEventArgs
 e)
{

    // Set the Clip property to a new region.
    e.Graphics.Clip = new Region(new Rectangle(10,
 10, 100, 200));

    // Fill the region.
    e.Graphics.FillRegion(Brushes.LightSalmon, e.Graphics.Clip);

    // Demonstrate the clip region by drawing a string
    // at the outer edge of the region.
    e.Graphics.DrawString("Outside of Clip", new Font("Arial",
 
        12.0F, FontStyle.Regular), Brushes.Black, 0.0F, 0.0F);

}

C++

private:
   void SetAndFillClip( PaintEventArgs^ e )
   {
      // Set the Clip property to a new region.
      e->Graphics->Clip = gcnew System::Drawing::Region( Rectangle(10,10,100,200)
 );

      // Fill the region.
      e->Graphics->FillRegion( Brushes::LightSalmon, e->Graphics->Clip
 );

      // Demonstrate the clip region by drawing a string
      // at the outer edge of the region.
      e->Graphics->DrawString( "Outside of Clip", gcnew System::Drawing::Font(
 "Arial",12.0F,FontStyle::Regular ), Brushes::Black, 0.0F, 0.0F );
   }

J#

private void SetAndFillClip(PaintEventArgs
 e)
{
    // Set the Clip property to a new region.
    e.get_Graphics().set_Clip(new Region(new
 Rectangle(10, 10, 100, 200)));

    // Fill the region.
    e.get_Graphics().FillRegion(Brushes.get_LightSalmon(),
        e.get_Graphics().get_Clip());

    // Demonstrate the clip region by drawing a string
    // at the outer edge of the region.
    e.get_Graphics().DrawString("Outside of Clip", 
        new Font("Arial", 12, FontStyle.Regular), 
        Brushes.get_Black(), 0, 0);
} //SetAndFillClip

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間