Graphics.Clip Propriété

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Graphics.cs

Obtient ou définit une Region valeur qui limite la zone de dessin de ce 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

Valeur de propriété

Region

Qui Region limite la partie de celle-ci Graphics actuellement disponible pour le dessin.

Exemples

L’exemple de code suivant illustre l’utilisation de la Clip propriété. Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la SetAndFillClip gestion de l’événement du Paint formulaire, en passant e en tant que 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

Remarques

La modification de l’objet Region retourné par la Clip propriété n’affecte pas le dessin suivant avec l’objet Graphics . Pour modifier la région de clip, remplacez la valeur de Clip propriété par un nouvel Region objet. Pour déterminer si la région de découpage est infinie, récupérez la Clip propriété et appelez sa IsInfinite méthode.