Graphics.ExcludeClip Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- Graphics.cs
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
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.
Se aplica a
ExcludeClip(Rectangle)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
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.