Graphics.Clip Graphics.Clip Graphics.Clip Graphics.Clip Property

정의

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

속성 값

현재 그리기에 사용할 수 있는 이 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.

적용 대상