Graphics.Clip Eigenschaft

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Quelle:

Graphics.cs

Dient zum Abrufen oder Festlegen eines Region Werts, der den Zeichnungsbereich dieses GraphicsBereichs begrenzt.

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

Eigenschaftswert

Region

Ein Region Bereich, der den Teil begrenzt, der Graphics derzeit für die Zeichnung verfügbar ist.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Clip Eigenschaft veranschaulicht. Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die SetAndFillClip Methode beim Behandeln des Formularereignisses Paint auf und übergeben als ePaintEventArgs.

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

Hinweise

Das Ändern des Region von der Eigenschaft zurückgegebenen Objekts wirkt sich nicht auf die Clip nachfolgende Zeichnung mit dem Graphics Objekt aus. Um den Clipbereich zu ändern, ersetzen Sie den Clip Eigenschaftswert durch ein neues Region Objekt. Um zu bestimmen, ob der Clippingbereich unendlich ist, rufen Sie die Clip Eigenschaft ab, und rufen Sie dessen IsInfinite Methode auf.