Pen.Dispose Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Pen.cs

Rilascia tutte le risorse usate da questa classe Pen.

public:
 virtual void Dispose();

public void Dispose ();

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

Public Sub Dispose ()

Implementazioni

Dispose()

Esempio

Nell'esempio di codice seguente vengono illustrati gli effetti dell'impostazione delle Width proprietà e LineJoin e viene illustrato come chiamare il Dispose metodo per un Penoggetto .

Questo esempio è progettato per essere usato con Windows Forms. Incollare il codice in un modulo e chiamare il ShowLineJoin metodo durante la gestione dell'evento del Paint modulo, passando e come 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

Commenti

La chiamata Dispose consente alle risorse usate da questo Brush oggetto di essere riallocate per altri scopi.

Chiamare il metodo Dispose dopo aver terminato di utilizzare l'oggetto Pen. Il metodo Dispose lascia l'oggetto Pen in una condizione di inutilizzabilità. Dopo aver chiamato Dispose, è necessario rilasciare tutti i riferimenti all'oggetto Pen in modo che il Garbage Collector possa recuperare la memoria che l'oggetto Pen occupava. Per altre informazioni, vedere Pulizia delle risorse non gestite e implementazione di un metodo Dispose.

Nota

Chiamare sempre il metodo Dispose prima di rilasciare l'ultimo riferimento a Pen. In caso contrario, le risorse utilizzate non verranno liberate finché il metodo Pen dell'oggetto Finalize non viene richiamato dal Garbage Collector.