Graphics.ExcludeClip Graphics.ExcludeClip Graphics.ExcludeClip Graphics.ExcludeClip Method

Definizione

Aggiorna l'area di visualizzazione di questo oggetto Graphics per escludere l'area specificata da una struttura Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

Overload

ExcludeClip(Region) ExcludeClip(Region) ExcludeClip(Region)

Aggiorna l'area di visualizzazione di questo oggetto Graphics per escludere l'area specificata da un oggetto Region.Updates the clip region of this Graphics to exclude the area specified by a Region.

ExcludeClip(Rectangle) ExcludeClip(Rectangle) ExcludeClip(Rectangle) ExcludeClip(Rectangle)

Aggiorna l'area di visualizzazione di questo oggetto Graphics per escludere l'area specificata da una struttura Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

ExcludeClip(Region) ExcludeClip(Region) ExcludeClip(Region)

Aggiorna l'area di visualizzazione di questo oggetto Graphics per escludere l'area specificata da un oggetto Region.Updates the clip region of this Graphics to exclude the area specified by a Region.

public:
 void ExcludeClip(System::Drawing::Region ^ region);
public void ExcludeClip (System.Drawing.Region region);
member this.ExcludeClip : System.Drawing.Region -> unit

Parametri

region
Region Region Region Region

Oggetto Region che specifica l'area da escludere dall'area di visualizzazione.Region that specifies the region to exclude from the clip region.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea un rettangolo di 100 pixel di 100 pixel il cui angolo superiore sinistro è in corrispondenza della coordinata (100, 100).Creates a 100 pixel by 100 pixel rectangle whose upper-left corner is at the coordinate (100, 100).

  • Imposta l'area di visualizzazione in modo da escludere il rettangolo.Sets the clipping region to exclude the rectangle.

  • Riempie un pixel 300 in base al rettangolo di 300 pixel il cui angolo superiore sinistro si trova nella coordinata (0,0) con un pennello a tinta unita blu.Fills a 300 pixel by 300 pixel rectangle whose upper-left corner is at the coordinate (0, 0) with a solid blue brush.

Il risultato è un rettangolo blu con un'area quadrata verso l'angolo inferiore destro mancante.The result is a blue rectangle with a square area toward its lower-right corner missing.

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 region parametro dall'area di ritaglio corrente e assegna l'area risultante Clip alla proprietà di Graphics.This method excludes the area specified by the region parameter from the current clip region and assigns the resulting area to the Clip property of this Graphics.

ExcludeClip(Rectangle) ExcludeClip(Rectangle) ExcludeClip(Rectangle) ExcludeClip(Rectangle)

Aggiorna l'area di visualizzazione di questo oggetto Graphics per escludere l'area specificata da una struttura Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

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 Rectangle Rectangle

Struttura Rectangle che specifica il rettangolo da escludere dall'area di visualizzazione.Rectangle structure that specifies the rectangle to exclude from the clip region.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea un rettangolo di 100 pixel di 100 pixel il cui angolo superiore sinistro è in corrispondenza della coordinata (100, 100).Creates a 100 pixel by 100 pixel rectangle whose upper-left corner is at the coordinate (100, 100).

  • Crea un'area definita dal rettangolo.Creates a region defined by the rectangle.

  • Imposta l'area di visualizzazione in modo da escludere l'area rettangolare.Sets the clipping region to exclude the rectangular region.

  • Riempie un pixel 300 in base al rettangolo di 300 pixel il cui angolo superiore sinistro si trova nella coordinata (0,0) con un pennello a tinta unita blu.Fills a 300 pixel by 300 pixel rectangle whose upper-left corner is at the coordinate (0, 0) with a solid blue brush.

Il risultato è un rettangolo blu con un'area quadrata verso l'angolo inferiore destro mancante.The result is a blue rectangle with a square region toward its lower-right corner missing.

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 rect parametro dall'area di ritaglio corrente e assegna l'area risultante Clip alla proprietà di Graphics.This method excludes the area specified by the rect parameter from the current clip region and assigns the resulting area to the Clip property of this Graphics.

Si applica a