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

Definición

Establece la región de recorte de este Graphics en la propiedad Clip del Graphics especificado.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

Sobrecargas

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

Establece la región de recorte de este Graphics en el resultado de la operación especificada que combina la región de recorte actual y el Region especificado.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)

Establece la región de recorte de este Graphics en el resultado de la operación que se indica que combina la región de recorte actual y el rectángulo especificado mediante una estructura 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)

Establece la región de recorte de este Graphics en el resultado de la operación que se indica que combina la región de recorte actual y el rectángulo especificado mediante una estructura 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)

Establece la región de recorte de este Graphics en el resultado de la operación especificada que combina la región de recorte actual y el GraphicsPath especificado.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)

Establece la región de recorte de este Graphics en el resultado de la operación de combinación especificada de la región de recorte actual y la propiedad Clip del Graphics indicado.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)

Establece la región de recorte de este Graphics en el rectángulo especificado mediante una estructura Rectangle.Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

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

Establece la región de recorte de este Graphics en la propiedad Clip del Graphics especificado.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

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

Establece la región de recorte de este Graphics en el GraphicsPath especificado.Sets the clipping region of this Graphics to the specified GraphicsPath.

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

Establece la región de recorte de este Graphics en el rectángulo especificado mediante una estructura 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)

Establece la región de recorte de este Graphics en el resultado de la operación especificada que combina la región de recorte actual y el Region especificado.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

Parámetros

region
Region Region Region Region

Region que se va a combinar.Region to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Miembro de la enumeración CombineMode que especifica la operación de combinación que se utilizará.Member from the CombineMode enumeration that specifies the combining operation to use.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un pequeño rectángulo para la región de recorte.Creates a small rectangle for the clipping region.

  • Establece la región de recorte en el rectángulo Replace con el miembro.Sets the clipping region to the rectangle with the Replace member.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un rectángulo pequeño, relleno y negro.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)

Establece la región de recorte de este Graphics en el resultado de la operación que se indica que combina la región de recorte actual y el rectángulo especificado mediante una estructura 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

Parámetros

rect
RectangleF RectangleF RectangleF RectangleF

Estructura RectangleF que se va a combinar.RectangleF structure to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Miembro de la enumeración CombineMode que especifica la operación de combinación que se utilizará.Member of the CombineMode enumeration that specifies the combining operation to use.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un pequeño rectángulo para la región de recorte.Creates a small rectangle for the clipping region.

  • Establece la región de recorte en el rectángulo Replace con el miembro.Sets the clipping region to the rectangle with the Replace member.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un rectángulo pequeño, relleno y negro.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)

Establece la región de recorte de este Graphics en el resultado de la operación que se indica que combina la región de recorte actual y el rectángulo especificado mediante una estructura 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

Parámetros

rect
Rectangle Rectangle Rectangle Rectangle

Estructura Rectangle que se va a combinar.Rectangle structure to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Miembro de la enumeración CombineMode que especifica la operación de combinación que se utilizará.Member of the CombineMode enumeration that specifies the combining operation to use.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un pequeño rectángulo para la región de recorte.Creates a small rectangle for the clipping region.

  • Establece la región de recorte en el rectángulo Replace con el miembro.Sets the clipping region to the rectangle with the Replace member.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un rectángulo pequeño, relleno y negro.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)

Establece la región de recorte de este Graphics en el resultado de la operación especificada que combina la región de recorte actual y el GraphicsPath especificado.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

Parámetros

combineMode
CombineMode CombineMode CombineMode CombineMode

Miembro de la enumeración CombineMode que especifica la operación de combinación que se utilizará.Member of the CombineMode enumeration that specifies the combining operation to use.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una ruta de acceso de gráficos y agrega una elipse a la ruta de acceso.Creates a graphics path and adds an ellipse to the path.

  • Establece la región de recorte en el trazado elíptico Replace con el miembro.Sets the clipping region to the elliptical path with the Replace member.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es una elipse negra rellena.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

Comentarios

Si la ruta de acceso de los path gráficos representada por el parámetro no está cerrada, se agrega un segmento adicional desde el último punto hasta el primer punto para cerrar la ruta de acceso.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)

Establece la región de recorte de este Graphics en el resultado de la operación de combinación especificada de la región de recorte actual y la propiedad Clip del Graphics indicado.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

Parámetros

g
Graphics Graphics Graphics Graphics

Graphics que especifica la región de recorte que se va a combinar.Graphics that specifies the clip region to combine.

combineMode
CombineMode CombineMode CombineMode CombineMode

Miembro de la enumeración CombineMode que especifica la operación de combinación que se utilizará.Member of the CombineMode enumeration that specifies the combining operation to use.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de Form eventos, así como thisForm, para el ejemplo.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. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un temporal Graphics thisForm apartirdeldelejemplo.FormCreates a temporary Graphics from the thisFormForm of the example.

  • Establece la región de recorte del Graphics temporal en un cuadrado pequeño.Sets the clipping region of the temporary Graphics to a small square.

  • Actualiza la región de recorte del objeto gráfico del formulario al nuevo Graphics con el Replace miembro.Updates the clipping region of the form's graphic object to that of the new Graphics with the Replace member.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un cuadrado pequeño, relleno y negro.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)

Establece la región de recorte de este Graphics en el rectángulo especificado mediante una estructura 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)

Parámetros

rect
Rectangle Rectangle Rectangle Rectangle

Estructura Rectangle que representa la nueva región de recorte.Rectangle structure that represents the new clip region.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un pequeño rectángulo para la región de recorte.Creates a small rectangle for the clipping region.

  • Establece la región de recorte en el rectángulo.Sets the clipping region to the rectangle.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un rectángulo pequeño, relleno y negro.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)

Establece la región de recorte de este Graphics en la propiedad Clip del Graphics especificado.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)

Parámetros

g
Graphics Graphics Graphics Graphics

Graphics del que se va a tomar la nueva región de recorte.Graphics from which to take the new clip region.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de Form eventos, así como thisForm, para el ejemplo.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. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un temporal Graphics thisForm apartirdeldelejemplo.FormCreates a temporary Graphics from the thisFormForm of the example.

  • Establece la región de recorte del Graphics temporal en un cuadrado pequeño.Sets the clipping region of the temporary Graphics to a small square.

  • Actualiza la región de recorte del objeto gráfico del formulario a la del temporal Graphics.Updates the clipping region of the form's graphic object to that of the temporary Graphics.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un cuadrado pequeño, relleno y negro.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)

Establece la región de recorte de este Graphics en el GraphicsPath especificado.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)

Parámetros

path
GraphicsPath GraphicsPath GraphicsPath GraphicsPath

GraphicsPath que representa la nueva región de recorte.GraphicsPath that represents the new clip region.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una ruta de acceso de gráficos y agrega una elipse a la ruta de acceso.Creates a graphics path and adds an ellipse to the path.

  • Establece la región de recorte en el trazado elíptico.Sets the clipping region to the elliptical path.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es una elipse negra rellena.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

Comentarios

Si la ruta de acceso de los path gráficos representada por el parámetro no está cerrada, se agrega un segmento adicional desde el último punto hasta el primer punto para cerrar la ruta de acceso.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)

Establece la región de recorte de este Graphics en el rectángulo especificado mediante una estructura 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)

Parámetros

rect
RectangleF RectangleF RectangleF RectangleF

Estructura RectangleF que representa la nueva región de recorte.RectangleF structure that represents the new clip region.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un pequeño rectángulo para la región de recorte.Creates a small rectangle for the clipping region.

  • Establece la región de recorte en el rectángulo.Sets the clipping region to the rectangle.

  • Rellena un rectángulo grande con un pincel negro sólido.Fills a large rectangle with a solid black brush.

El resultado es un rectángulo pequeño, relleno y negro.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

Se aplica a