Graphics.Clip 屬性

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

Graphics.cs

取得或設定 Region，它會限制這個 Graphics 的繪圖區域。

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

public System.Drawing.Region Clip { get; set; }

member this.Clip : System.Drawing.Region with get, set

Public Property Clip As Region

屬性值

Region

Region，它會限制這個 Graphics 目前可用於繪圖的部分。

範例

下列程式代碼範例示範 屬性的使用 Clip 。 此範例的設計目的是要與 Windows Forms 搭配使用。 將程式代碼貼到表單中，並在處理表單的事件Paint時呼叫 SetAndFillClip 方法，並傳遞e為 PaintEventArgs。

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

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

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

備註

Region修改屬性所傳Clip回的物件不會影響對象的Graphics後續繪圖。 若要變更剪輯區域，請將 Clip 屬性值取代為新的 Region 物件。 若要判斷裁剪區域是否無限，請擷取 Clip 屬性並呼叫其 IsInfinite 方法。