Graphics.ExcludeClip Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Atualiza a região de clipe desta Graphics para excluir a área especificada por uma estrutura de Rectangle.

Sobrecargas

ExcludeClip(Region)	Atualiza a região do clipe desta Graphics para excluir a área especificada por um Region.
ExcludeClip(Rectangle)	Atualiza a região de clipe desta Graphics para excluir a área especificada por uma estrutura de Rectangle.

ExcludeClip(Region)

Atualiza a região do clipe desta Graphics para excluir a área especificada por um 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 a região a ser excluída da região do clipe.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um retângulo de 100 pixels por 100 pixels cujo canto superior esquerdo está na coordenada (100, 100).

• Define a região de recorte para excluir o retângulo.

• Preenche um retângulo de 300 pixels por 300 pixels cujo canto superior esquerdo está na coordenada (0, 0) com um pincel azul sólido.

O resultado é um retângulo azul com uma área quadrada em direção ao canto inferior direito ausente.

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

Comentários

Esse método exclui a área especificada pelo parâmetro region da região de clipe atual e atribui a área resultante à propriedade Clip deste Graphics.

ExcludeClip(Rectangle)

Atualiza a região de clipe desta Graphics para excluir a área especificada por uma estrutura 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 estrutura que especifica o retângulo a ser excluído da região do clipe.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um retângulo de 100 pixels por 100 pixels cujo canto superior esquerdo está na coordenada (100, 100).

• Cria uma região definida pelo retângulo.

• Define a região de recorte para excluir a região retangular.

• Preenche um retângulo de 300 pixels por 300 pixels cujo canto superior esquerdo está na coordenada (0, 0) com um pincel azul sólido.

O resultado é um retângulo azul com uma região quadrada em direção ao canto inferior direito ausente.

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

Comentários

Esse método exclui a área especificada pelo parâmetro rect da região de clipe atual e atribui a área resultante à propriedade Clip deste Graphics.