Region.Exclude Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v9.0.0-preview.6.24327.6

Actualiza este Region a la parte de su interior que no se interseca con la estructura de Rectangle especificada.

Sobrecargas

Exclude(Region)	Actualiza este Region para contener solo la parte de su interior que no interseca con el Regionespecificado.
Exclude(GraphicsPath)	Actualiza este Region para contener solo la parte de su interior que no interseca con el GraphicsPathespecificado.
Exclude(Rectangle)	Actualiza este Region para contener solo la parte de su interior que no se interseca con la estructura de Rectangle especificada.
Exclude(RectangleF)	Actualiza este Region para contener solo la parte de su interior que no se interseca con la estructura de RectangleF especificada.

Exclude(Region)

Source:

Region.cs

Actualiza este Region para contener solo la parte de su interior que no interseca con el Regionespecificado.

C#

public void Exclude (System.Drawing.Region region);

Parámetros

region

Region

El Region que se va a excluir de este Region.

Excepciones

ArgumentNullException

region es null.

Ejemplos

Para obtener ejemplos de código, consulte los métodos Exclude(RectangleF) y Complement(Region).

Exclude(GraphicsPath)

Source:

Region.cs

Actualiza este Region para contener solo la parte de su interior que no interseca con el GraphicsPathespecificado.

C#

public void Exclude (System.Drawing.Drawing2D.GraphicsPath path);

Parámetros

path

GraphicsPath

El GraphicsPath que se va a excluir de este Region.

Excepciones

ArgumentNullException

path es null.

Ejemplos

En el ejemplo de código siguiente se muestra el constructor Region y los métodos Exclude y Dispose.

Este ejemplo está diseñado para usarse con Windows Forms. Pegue el código en un formulario y llame al método FillRegionExcludingPath al controlar el evento Paint del formulario, pasando e como PaintEventArgs.

C#

private void FillRegionExcludingPath(PaintEventArgs e)
{

    // Create the region using a rectangle.
    Region myRegion = new Region(new Rectangle(20, 20, 100, 100));

    // Create the GraphicsPath.
    System.Drawing.Drawing2D.GraphicsPath path = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25);

    // Exclude the circle from the region.
    myRegion.Exclude(path);

    // Retrieve a Graphics object from the form.
    Graphics formGraphics = e.Graphics;

    // Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion);

    // Dispose of the path and region objects.
    path.Dispose();
    myRegion.Dispose();
}

Exclude(Rectangle)

Source:

Region.cs

Actualiza este Region para contener solo la parte de su interior que no se interseca con la estructura de Rectangle especificada.

C#

public void Exclude (System.Drawing.Rectangle rect);

Parámetros

rect

Rectangle

Estructura Rectangle que se va a excluir de este Region.

Ejemplos

Para obtener un ejemplo de código, consulte el método Exclude(RectangleF).

Exclude(RectangleF)

Source:

Region.cs

Actualiza este Region para contener solo la parte de su interior que no se interseca con la estructura de RectangleF especificada.

C#

public void Exclude (System.Drawing.RectangleF rect);

Parámetros

rect

RectangleF

Estructura RectangleF que se va a excluir de este Region.

Ejemplos

El ejemplo 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 y lo dibuja en la pantalla en negro

• Crea un segundo rectángulo que interseca con el primero y lo dibuja en la pantalla en rojo.

• Crea una región con el primer rectángulo.

• Obtiene el área no aislada de la región cuando se combina con el segundo rectángulo.

• Rellena el área no aislada con azul y la dibuja en la pantalla.

Observe que el área del área de la región que no se interseca con el rectángulo está coloreado azul.

C#

public void Exclude_RectF_Example(PaintEventArgs e)
{
             
    // Create the first rectangle and draw it to the screen in black.
    Rectangle regionRect = new Rectangle(20, 20, 100, 100);
    e.Graphics.DrawRectangle(Pens.Black, regionRect);
             
    // Create the second rectangle and draw it to the screen in red.
    RectangleF complementRect = new RectangleF(90, 30, 100, 100);
    e.Graphics.DrawRectangle(Pens.Red,
        Rectangle.Round(complementRect));
             
    // Create a region using the first rectangle.
    Region myRegion = new Region(regionRect);
             
    // Get the nonexcluded area of myRegion when combined with
             
    // complementRect.
    myRegion.Exclude(complementRect);
             
    // Fill the nonexcluded area of myRegion with blue.
    SolidBrush myBrush = new SolidBrush(Color.Blue);
    e.Graphics.FillRegion(myBrush, myRegion);
}