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

Definición

Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una estructura Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

Sobrecargas

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

Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una Region.Updates the clip region of this Graphics to exclude the area specified by a Region.

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

Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una estructura Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

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

Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una 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

Parámetros

region
Region Region Region Region

Region que especifica la región que se debe excluir de la región de recorte.Region that specifies the region to exclude from the 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 rectángulo de 100 píxeles por 100 píxeles cuya esquina superior izquierda se encuentra en la coordenada (100, 100).Creates a 100 pixel by 100 pixel rectangle whose upper-left corner is at the coordinate (100, 100).

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

  • Rellena un rectángulo de 300 por 300 píxeles cuya esquina superior izquierda está en la coordenada (0,0) con un pincel azul sólido.Fills a 300 pixel by 300 pixel rectangle whose upper-left corner is at the coordinate (0, 0) with a solid blue brush.

El resultado es un rectángulo azul con un área cuadrada hacia la esquina inferior derecha que falta.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

Comentarios

Este método excluye el área especificada por el region parámetro de la región de recorte actual y asigna el área resultante a la Clip propiedad de este 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)

Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una estructura 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)

Parámetros

rect
Rectangle Rectangle Rectangle Rectangle

Estructura Rectangle que especifica el rectángulo que se debe excluir de la región de recorte.Rectangle structure that specifies the rectangle to exclude from the 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 rectángulo de 100 píxeles por 100 píxeles cuya esquina superior izquierda se encuentra en la coordenada (100, 100).Creates a 100 pixel by 100 pixel rectangle whose upper-left corner is at the coordinate (100, 100).

  • Crea una región definida por el rectángulo.Creates a region defined by the rectangle.

  • Establece la región de recorte para excluir la región rectangular.Sets the clipping region to exclude the rectangular region.

  • Rellena un rectángulo de 300 por 300 píxeles cuya esquina superior izquierda está en la coordenada (0,0) con un pincel azul sólido.Fills a 300 pixel by 300 pixel rectangle whose upper-left corner is at the coordinate (0, 0) with a solid blue brush.

El resultado es un rectángulo azul con una región cuadrada hacia la esquina inferior derecha que falta.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

Comentarios

Este método excluye el área especificada por el rect parámetro de la región de recorte actual y asigna el área resultante a la Clip propiedad de este 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.

Se aplica a