Graphics.Clip 속성

정의

Graphics의 그리기 영역을 제한하는 Region을 가져오거나 설정합니다.Gets or sets a Region that limits the drawing region of this 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

현재 그리기에 사용할 수 있는 이 Graphics의 부분을 제한하는 Region입니다.A Region that limits the portion of this Graphics that is currently available for drawing.

예제

다음 코드 예제에서는 Clip 속성입니다.The following code example demonstrates the use of the Clip property. 이 예제는 Windows Forms와 함께 사용 하도록 설계 되었습니다.This example is designed to be used with Windows Forms. 폼에 코드를 붙여넣고 SetAndFillClip 폼의 이벤트를 처리할 때를로 전달 하 여 메서드를 호출 합니다 Paint e PaintEventArgs .Paste the code into a form and call the SetAndFillClip method when handling the form's Paint event, passing e as 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 .Modifying the Region object returned by the Clip property does not affect subsequent drawing with the Graphics object. 클립 영역을 변경 하려면 Clip 속성 값을 새 Region 개체로 바꿉니다.To change the clip region, replace the Clip property value with a new Region object. 클리핑 영역이 무한 한지 여부를 확인 하려면 속성을 검색 하 Clip 고 해당 메서드를 호출 IsInfinite 합니다.To determine whether the clipping region is infinite, retrieve the Clip property and call its IsInfinite method.

적용 대상