Pen.Dispose Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Pen.cs

Libera todos os recursos usados por este Pen.

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implementações

Dispose()

Exemplos

O exemplo de código a seguir demonstra os efeitos da configuração das Width propriedades e LineJoin e mostra como chamar o Dispose método para um Pen.

Este exemplo foi projetado para ser usado com Windows Forms. Cole o código em um formulário e chame o ShowLineJoin método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }

private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}

Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

Comentários

Chamar Dispose permite que os recursos usados por isso Brush sejam realocados para outras finalidades.

Chame Dispose quando terminar de usar o Pen. O Dispose método deixa o Pen em um estado inutilizável. Depois de chamar Dispose, você deve liberar todas as referências para o Pen para que o coletor de lixo possa recuperar a memória que o Pen estava ocupando. Para obter mais informações, consulte Limpando recursos não gerenciados e implementando um método dispose.

Observação

Sempre chame Dispose antes de liberar sua última referência ao Pen. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o Pen método do Finalize objeto.