Graphics.ExcludeClip Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Aggiorna l'area di ritaglio di questo Graphics per escludere l'area specificata da una struttura Rectangle.

Overload

ExcludeClip(Region)	Aggiorna l'area di ritaglio di questo Graphics per escludere l'area specificata da un Region.
ExcludeClip(Rectangle)	Aggiorna l'area di ritaglio di questo Graphics per escludere l'area specificata da una struttura Rectangle.

ExcludeClip(Region)

Aggiorna l'area di ritaglio di questo Graphics per escludere l'area specificata da 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)

Parametri

region

Region

Region che specifica l'area da escludere dall'area di ritaglio.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un rettangolo di 100 pixel di 100 pixel il cui angolo superiore sinistro si trova alla coordinata (100, 100).

• Imposta l'area di ritaglio per escludere il rettangolo.

• Riempie un rettangolo di 300 pixel di 300 pixel il cui angolo superiore sinistro si trova alla coordinata (0, 0) con un pennello blu a tinta unita.

Il risultato è un rettangolo blu con un'area quadrata verso l'angolo inferiore destro mancante.

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

Commenti

Questo metodo esclude l'area specificata dal parametro region dall'area di ritaglio corrente e assegna l'area risultante alla proprietà Clip di questo Graphics.

ExcludeClip(Rectangle)

Aggiorna l'area di ritaglio di questo Graphics per escludere l'area specificata da una struttura 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)

Parametri

rect

Rectangle

Rectangle struttura che specifica il rettangolo da escludere dall'area di ritaglio.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un rettangolo di 100 pixel di 100 pixel il cui angolo superiore sinistro si trova alla coordinata (100, 100).

• Crea un'area definita dal rettangolo.

• Imposta l'area di ritaglio per escludere l'area rettangolare.

• Riempie un rettangolo di 300 pixel di 300 pixel il cui angolo superiore sinistro si trova alla coordinata (0, 0) con un pennello blu a tinta unita.

Il risultato è un rettangolo blu con un'area quadrata verso l'angolo inferiore destro mancante.

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

Commenti

Questo metodo esclude l'area specificata dal parametro rect dall'area di ritaglio corrente e assegna l'area risultante alla proprietà Clip di questo Graphics.