Graphics.ExcludeClip Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v9.0.0-rc.2.24474.1

Actualiza la región del clip de este Graphics para excluir el área especificada por una estructura de Rectangle.

Sobrecargas

ExcludeClip(Region)	Actualiza la región del clip de este Graphics para excluir el área especificada por un Region.
ExcludeClip(Rectangle)	Actualiza la región del clip de este Graphics para excluir el área especificada por una estructura de Rectangle.

ExcludeClip(Region)

Source:

Graphics.cs

Actualiza la región del clip de este Graphics para excluir el área especificada por 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)

Parámetros

region

Region

Region que especifica la región que se va a excluir de la región del clip.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea un rectángulo de 100 píxeles por 100 píxeles cuya esquina superior izquierda está en la coordenada (100, 100).

• Establece la región de recorte para excluir el rectángulo.

• Rellena un rectángulo de 300 píxeles por 300 píxeles cuya esquina superior izquierda está en la coordenada (0, 0) con un pincel azul sólido.

El resultado es un rectángulo azul con un área cuadrada hacia su esquina inferior derecha que falta.

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 parámetro region de la región del clip actual y asigna el área resultante a la propiedad Clip de este Graphics.

ExcludeClip(Rectangle)

Source:

Graphics.cs

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

Parámetros

rect

Rectangle

Rectangle estructura que especifica el rectángulo que se va a excluir de la región del clip.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea un rectángulo de 100 píxeles por 100 píxeles cuya esquina superior izquierda está en la coordenada (100, 100).

• Crea una región definida por el rectángulo.

• Establece la región de recorte para excluir la región rectangular.

• Rellena un rectángulo de 300 píxeles por 300 píxeles cuya esquina superior izquierda está en la coordenada (0, 0) con un pincel azul sólido.

El resultado es un rectángulo azul con una región cuadrada hacia su esquina inferior derecha que falta.

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 parámetro rect de la región del clip actual y asigna el área resultante a la propiedad Clip de este Graphics.