Graphics.SetClip Graphics.SetClip Graphics.SetClip Graphics.SetClip Method

Definizione

Imposta l'area di visualizzazione di questo oggetto Graphics sulla proprietà Clip dell'oggetto Graphics specificato.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

Overload

SetClip(Region, CombineMode) SetClip(Region, CombineMode) SetClip(Region, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e l'oggetto Region specificato.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e il rettangolo specificato da una struttura RectangleF.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a RectangleF structure.

SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e il rettangolo specificato da una struttura Rectangle.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e l'oggetto GraphicsPath specificato.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified GraphicsPath.

SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione indicata di combinazione tra l'area di visualizzazione corrente e la proprietà Clip dell'oggetto Graphics specificato.Sets the clipping region of this Graphics to the result of the specified combining operation of the current clip region and the Clip property of the specified Graphics.

SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle)

Imposta l'area di visualizzazione di questo oggetto Graphics sul rettangolo specificato da una struttura Rectangle.Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

SetClip(Graphics) SetClip(Graphics) SetClip(Graphics) SetClip(Graphics)

Imposta l'area di visualizzazione di questo oggetto Graphics sulla proprietà Clip dell'oggetto Graphics specificato.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath)

Imposta l'area di visualizzazione di questo oggetto Graphics sull'oggetto GraphicsPath specificato.Sets the clipping region of this Graphics to the specified GraphicsPath.

SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF)

Imposta l'area di visualizzazione di questo oggetto Graphics sul rettangolo specificato da una struttura RectangleF.Sets the clipping region of this Graphics to the rectangle specified by a RectangleF structure.

SetClip(Region, CombineMode) SetClip(Region, CombineMode) SetClip(Region, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e l'oggetto Region specificato.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

public:
 void SetClip(System::Drawing::Region ^ region, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Region region, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Region * System.Drawing.Drawing2D.CombineMode -> unit

Parametri

region
Region Region Region Region

Oggetto Region da combinare.Region to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Membro dell'enumerazione CombineMode che specifica l'operazione di combinazione da utilizzare.Member from the CombineMode enumeration that specifies the combining operation to use.

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 piccolo rettangolo per l'area di ridimensionamento.Creates a small rectangle for the clipping region.

  • Imposta l'area di ridimensionamento sul rettangolo con il Replace membro.Sets the clipping region to the rectangle with the Replace member.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un rettangolo piccolo, pieno e nero.The result is a small, filled, black rectangle.

public:
   void SetClipRegionCombine( PaintEventArgs^ e )
   {
      // Create region for clipping.
      System::Drawing::Region^ clipRegion = gcnew System::Drawing::Region( Rectangle(0,0,100,100) );

      // Set clipping region of graphics to region.
      e->Graphics->SetClip( clipRegion, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRegionCombine(PaintEventArgs e)
{

    // Create region for clipping.
    Region clipRegion = new Region(new Rectangle(0, 0, 100, 100));

    // Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRegionCombine(ByVal e As PaintEventArgs)

    ' Create region for clipping.
    Dim clipRegion As New [Region](New Rectangle(0, 0, 100, 100))

    ' Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode) SetClip(RectangleF, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e il rettangolo specificato da una struttura RectangleF.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a RectangleF structure.

public:
 void SetClip(System::Drawing::RectangleF rect, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.RectangleF rect, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.RectangleF * System.Drawing.Drawing2D.CombineMode -> unit

Parametri

rect
RectangleF RectangleF RectangleF RectangleF

Struttura RectangleF da combinare.RectangleF structure to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Membro dell'enumerazione CombineMode che specifica le operazioni di combinazione da utilizzare.Member of the CombineMode enumeration that specifies the combining operation to use.

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 piccolo rettangolo per l'area di ridimensionamento.Creates a small rectangle for the clipping region.

  • Imposta l'area di ridimensionamento sul rettangolo con il Replace membro.Sets the clipping region to the rectangle with the Replace member.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un rettangolo piccolo, pieno e nero.The result is a small, filled, black rectangle.

public:
   void SetClipRectangleFCombine( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangleFCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangleFCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode) SetClip(Rectangle, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e il rettangolo specificato da una struttura Rectangle.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

public:
 void SetClip(System::Drawing::Rectangle rect, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Rectangle rect, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Rectangle * System.Drawing.Drawing2D.CombineMode -> unit

Parametri

rect
Rectangle Rectangle Rectangle Rectangle

Struttura Rectangle da combinare.Rectangle structure to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Membro dell'enumerazione CombineMode che specifica le operazioni di combinazione da utilizzare.Member of the CombineMode enumeration that specifies the combining operation to use.

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 piccolo rettangolo per l'area di ridimensionamento.Creates a small rectangle for the clipping region.

  • Imposta l'area di ridimensionamento sul rettangolo con il Replace membro.Sets the clipping region to the rectangle with the Replace member.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un rettangolo piccolo, pieno e nero.The result is a small, filled, black rectangle.

public:
   void SetClipRectangleCombine( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangleCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangleCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode) SetClip(GraphicsPath, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione di combinazione indicata tra l'area di visualizzazione corrente e l'oggetto GraphicsPath specificato.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified GraphicsPath.

public:
 void SetClip(System::Drawing::Drawing2D::GraphicsPath ^ path, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Drawing2D.GraphicsPath path, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Drawing2D.GraphicsPath * System.Drawing.Drawing2D.CombineMode -> unit

Parametri

combineMode
CombineMode CombineMode CombineMode CombineMode

Membro dell'enumerazione CombineMode che specifica le operazioni di combinazione da utilizzare.Member of the CombineMode enumeration that specifies the combining operation to use.

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 percorso grafico e aggiunge un'ellisse al percorso.Creates a graphics path and adds an ellipse to the path.

  • Imposta l'area di visualizzazione sul percorso ellittico con il Replace membro.Sets the clipping region to the elliptical path with the Replace member.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un'ellisse nera piena.The result is a filled, black ellipse.

public:
   void SetClipPathCombine( PaintEventArgs^ e )
   {
      // Create graphics path.
      GraphicsPath^ clipPath = gcnew GraphicsPath;
      clipPath->AddEllipse( 0, 0, 200, 100 );

      // Set clipping region to path.
      e->Graphics->SetClip( clipPath, CombineMode::Replace );

      // Fill rectangle to demonstrate clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipPathCombine(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipPathCombine(ByVal e As PaintEventArgs)

    ' Create graphics path.
    Dim clipPath As New GraphicsPath
    clipPath.AddEllipse(0, 0, 200, 100)

    ' Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace)

    ' Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

Commenti

Se il percorso grafico rappresentato dal path parametro non è chiuso, viene aggiunto un segmento aggiuntivo dall'ultimo punto al primo punto per chiudere il percorso.If the graphics path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.

SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode) SetClip(Graphics, CombineMode)

Imposta l'area di visualizzazione di questo oggetto Graphics sul risultato dell'operazione indicata di combinazione tra l'area di visualizzazione corrente e la proprietà Clip dell'oggetto Graphics specificato.Sets the clipping region of this Graphics to the result of the specified combining operation of the current clip region and the Clip property of the specified Graphics.

public:
 void SetClip(System::Drawing::Graphics ^ g, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Graphics g, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Graphics * System.Drawing.Drawing2D.CombineMode -> unit

Parametri

g
Graphics Graphics Graphics Graphics

Oggetto Graphics che specifica l'area di visualizzazione da combinare.Graphics that specifies the clip region to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Membro dell'enumerazione CombineMode che specifica le operazioni di combinazione da utilizzare.Member of the CombineMode enumeration that specifies the combining operation to use.

Esempi

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

  • Crea un oggetto Graphics temporaneo dall' thisForm oggetto Form dell'esempio.Creates a temporary Graphics from the thisFormForm of the example.

  • Imposta l'area di visualizzazione dell'oggetto temporaneo Graphics su un piccolo quadrato.Sets the clipping region of the temporary Graphics to a small square.

  • Aggiorna l'area di visualizzazione dell'oggetto grafico del form a quella del nuovo Graphics oggetto con il Replace membro.Updates the clipping region of the form's graphic object to that of the new Graphics with the Replace member.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un quadrato piccolo, pieno e nero.The result is a small, filled, black square.

public:
   void SetClipGraphicsCombine( PaintEventArgs^ e )
   {
      // Create temporary graphics object and set its clipping region.
      Graphics^ newGraphics = this->CreateGraphics();
      newGraphics->SetClip( Rectangle(0,0,100,100) );

      // Update clipping region of graphics to clipping region of new
      // graphics.
      e->Graphics->SetClip( newGraphics, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

      // Release new graphics.
      delete newGraphics;
   }
private void SetClipGraphicsCombine(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}
Private Sub SetClipGraphicsCombine(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.CreateGraphics()
    newGraphics.SetClip(New Rectangle(0, 0, 100, 100))

    ' Update clipping region of graphics to clipping region of new

    ' graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)

    ' Release new graphics.
    newGraphics.Dispose()
End Sub

SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle) SetClip(Rectangle)

Imposta l'area di visualizzazione di questo oggetto Graphics sul rettangolo specificato da una struttura Rectangle.Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

public:
 void SetClip(System::Drawing::Rectangle rect);
public void SetClip (System.Drawing.Rectangle rect);
member this.SetClip : System.Drawing.Rectangle -> unit
Public Sub SetClip (rect As Rectangle)

Parametri

rect
Rectangle Rectangle Rectangle Rectangle

Struttura Rectangle che rappresenta la nuova area di visualizzazione.Rectangle structure that represents the new 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 piccolo rettangolo per l'area di ridimensionamento.Creates a small rectangle for the clipping region.

  • Imposta l'area di ridimensionamento sul rettangolo.Sets the clipping region to the rectangle.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un rettangolo piccolo, pieno e nero.The result is a small, filled, black rectangle.

public:
   void SetClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangle(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Graphics) SetClip(Graphics) SetClip(Graphics) SetClip(Graphics)

Imposta l'area di visualizzazione di questo oggetto Graphics sulla proprietà Clip dell'oggetto Graphics specificato.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

public:
 void SetClip(System::Drawing::Graphics ^ g);
public void SetClip (System.Drawing.Graphics g);
member this.SetClip : System.Drawing.Graphics -> unit
Public Sub SetClip (g As Graphics)

Parametri

g
Graphics Graphics Graphics Graphics

Oggetto Graphics da cui trarre la nuova area di visualizzazione.Graphics from which to take the new 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 thisForm Form eventi e, per l'esempio.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler, as well as thisForm, the Form for the example. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea un oggetto Graphics temporaneo dall' thisForm oggetto Form dell'esempio.Creates a temporary Graphics from the thisFormForm of the example.

  • Imposta l'area di visualizzazione dell'oggetto temporaneo Graphics su un piccolo quadrato.Sets the clipping region of the temporary Graphics to a small square.

  • Aggiorna l'area di visualizzazione dell'oggetto grafico del form a quella di temporanea Graphics.Updates the clipping region of the form's graphic object to that of the temporary Graphics.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un quadrato piccolo, pieno e nero.The result is a small, filled, black square.

public:
   void SetClipGraphics( PaintEventArgs^ e )
   {
      // Create temporary graphics object and set its clipping region.
      Graphics^ newGraphics = this->CreateGraphics();
      newGraphics->SetClip( Rectangle(0,0,100,100) );

      // Update clipping region of graphics to clipping region of new
      // graphics.
      e->Graphics->SetClip( newGraphics );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

      // Release new graphics.
      delete newGraphics;
   }
private void SetClipGraphics(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}
Private Sub SetClipGraphics(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.CreateGraphics()
    newGraphics.SetClip(New Rectangle(0, 0, 100, 100))

    ' Update clipping region of graphics to clipping region of new

    ' graphics.
    e.Graphics.SetClip(newGraphics)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)

    ' Release new graphics.
    newGraphics.Dispose()
End Sub

SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath) SetClip(GraphicsPath)

Imposta l'area di visualizzazione di questo oggetto Graphics sull'oggetto GraphicsPath specificato.Sets the clipping region of this Graphics to the specified GraphicsPath.

public:
 void SetClip(System::Drawing::Drawing2D::GraphicsPath ^ path);
public void SetClip (System.Drawing.Drawing2D.GraphicsPath path);
member this.SetClip : System.Drawing.Drawing2D.GraphicsPath -> unit
Public Sub SetClip (path As GraphicsPath)

Parametri

path
GraphicsPath GraphicsPath GraphicsPath GraphicsPath

Oggetto GraphicsPath che rappresenta la nuova area di visualizzazione.GraphicsPath that represents the new 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 percorso grafico e aggiunge un'ellisse al percorso.Creates a graphics path and adds an ellipse to the path.

  • Imposta l'area di visualizzazione sul percorso ellittico.Sets the clipping region to the elliptical path.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un'ellisse nera piena.The result is a filled, black ellipse.

public:
   void SetClipPath( PaintEventArgs^ e )
   {
      // Create graphics path.
      GraphicsPath^ clipPath = gcnew GraphicsPath;
      clipPath->AddEllipse( 0, 0, 200, 100 );

      // Set clipping region to path.
      e->Graphics->SetClip( clipPath );

      // Fill rectangle to demonstrate clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipPath(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipPath(ByVal e As PaintEventArgs)

    ' Create graphics path.
    Dim clipPath As New GraphicsPath
    clipPath.AddEllipse(0, 0, 200, 100)

    ' Set clipping region to path.
    e.Graphics.SetClip(clipPath)

    ' Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

Commenti

Se il percorso grafico rappresentato dal path parametro non è chiuso, viene aggiunto un segmento aggiuntivo dall'ultimo punto al primo punto per chiudere il percorso.If the graphics path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.

SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF) SetClip(RectangleF)

Imposta l'area di visualizzazione di questo oggetto Graphics sul rettangolo specificato da una struttura RectangleF.Sets the clipping region of this Graphics to the rectangle specified by a RectangleF structure.

public:
 void SetClip(System::Drawing::RectangleF rect);
public void SetClip (System.Drawing.RectangleF rect);
member this.SetClip : System.Drawing.RectangleF -> unit
Public Sub SetClip (rect As RectangleF)

Parametri

rect
RectangleF RectangleF RectangleF RectangleF

Struttura RectangleF che rappresenta la nuova area di visualizzazione.RectangleF structure that represents the new 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 piccolo rettangolo per l'area di ridimensionamento.Creates a small rectangle for the clipping region.

  • Imposta l'area di ridimensionamento sul rettangolo.Sets the clipping region to the rectangle.

  • Riempie un rettangolo di grandi dimensioni con un pennello nero a tinta unita.Fills a large rectangle with a solid black brush.

Il risultato è un rettangolo piccolo, pieno e nero.The result is a small, filled, black rectangle.

public:
   void SetClipRectangleF( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangleF(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangleF(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

Si applica a