Graphics.ExcludeClip Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Met à jour la région clip de cette Graphics pour exclure la zone spécifiée par une structure Rectangle.

Surcharges

ExcludeClip(Region)	Met à jour la région clip de cette Graphics pour exclure la zone spécifiée par un Region.
ExcludeClip(Rectangle)	Met à jour la région clip de cette Graphics pour exclure la zone spécifiée par une structure Rectangle.

ExcludeClip(Region)

Met à jour la région clip de cette Graphics pour exclure la zone spécifiée par un Region.

public:
 void ExcludeClip(System::Drawing::Region ^ region);

public void ExcludeClip (System.Drawing.Region region);

member this.ExcludeClip : System.Drawing.Region -> unit

Public Sub ExcludeClip (region As Region)

Paramètres

region

Region

Region qui spécifie la région à exclure de la région clip.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Crée un rectangle de 100 pixels de 100 pixels dont le coin supérieur gauche se trouve à la coordonnée (100, 100).

• Définit la zone de découpage pour exclure le rectangle.

• Remplit un rectangle de 300 pixels de 300 pixels dont le coin supérieur gauche se trouve à la coordonnée (0, 0) avec un pinceau bleu unie.

Le résultat est un rectangle bleu avec une zone carrée vers son coin inférieur droit manquant.

public:
   void ExcludeClipRegion( PaintEventArgs^ e )
   {
      // Create rectangle for region.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Create region for exclusion.
      System::Drawing::Region^ excludeRegion = gcnew System::Drawing::Region( excludeRect );

      // Set clipping region to exclude region.
      e->Graphics->ExcludeClip( excludeRegion );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

public void ExcludeClipRegion(PaintEventArgs e)
{
             
    // Create rectangle for region.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Create region for exclusion.
    Region excludeRegion = new Region(excludeRect);
             
    // Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Public Sub ExcludeClipRegion(ByVal e As PaintEventArgs)

    ' Create rectangle for region.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Create region for exclusion.
    Dim excludeRegion As New [Region](excludeRect)

    ' Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion)

    ' Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    300, 300)
End Sub

Remarques

Cette méthode exclut la zone spécifiée par le paramètre region de la région de clip actuelle et affecte la zone résultante à la propriété Clip de cette Graphics.

ExcludeClip(Rectangle)

Met à jour la région clip de cette Graphics pour exclure la zone spécifiée par une structure Rectangle.

public:
 void ExcludeClip(System::Drawing::Rectangle rect);

public void ExcludeClip (System.Drawing.Rectangle rect);

member this.ExcludeClip : System.Drawing.Rectangle -> unit

Public Sub ExcludeClip (rect As Rectangle)

Paramètres

rect

Rectangle

Rectangle structure qui spécifie le rectangle à exclure de la région clip.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Crée un rectangle de 100 pixels de 100 pixels dont le coin supérieur gauche se trouve à la coordonnée (100, 100).

• Crée une région définie par le rectangle.

• Définit la zone de découpage pour exclure la région rectangulaire.

• Remplit un rectangle de 300 pixels de 300 pixels dont le coin supérieur gauche se trouve à la coordonnée (0, 0) avec un pinceau bleu unie.

Le résultat est un rectangle bleu avec une zone carrée vers son coin inférieur droit manquant.

public:
   void ExcludeClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for exclusion.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Set clipping region to exclude rectangle.
      e->Graphics->ExcludeClip( excludeRect );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

public void ExcludeClipRectangle(PaintEventArgs e)
{
             
    // Create rectangle for exclusion.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Public Sub ExcludeClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for exclusion.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect)

    ' Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    300, 300)
End Sub

Remarques

Cette méthode exclut la zone spécifiée par le paramètre rect de la région de clip actuelle et affecte la zone résultante à la propriété Clip de cette Graphics.