Graphics.ExcludeClip Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una estructura Rectangle.

Sobrecargas

ExcludeClip(Region)	Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una Region.
ExcludeClip(Rectangle)	Actualiza la región de recorte de este Graphics con el fin de excluir el área especificada por una estructura Rectangle.

ExcludeClip(Region)

Source:

Graphics.cs

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

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

ExcludeClip(Rectangle)

Source:

Graphics.cs

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

Estructura Rectangle que especifica el rectángulo que se debe excluir de la región de recorte.

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