Pen.Dispose Methode

public:
 virtual void Dispose();

public void Dispose();

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

Public Sub Dispose ()

Implementiert

Beispiele

Das folgende Codebeispiel veranschaulicht die Auswirkungen des Festlegens und der WidthLineJoin Eigenschaften und zeigt, wie die Dispose Methode für eine Pen.

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowLineJoin Methode beim Behandeln des Formularereignisses Paint auf und übergeben als ePaintEventArgs.

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

Hinweise

Das Aufrufen Dispose ermöglicht es, die von diesem Brush verwendeten Ressourcen für andere Zwecke neu zuzuordnen.

Rufen Sie an Dispose , wenn Sie mit der Verwendung der Pen. Die Dispose Methode verlässt den Pen nicht verwendbaren Zustand. Nach dem Aufrufen Disposemüssen Sie alle Verweise auf den Pen Garbage Collector freigeben, damit der Garbage Collector den Speicher zurückfordern kann, den sie Pen belegt hat. Weitere Informationen finden Sie unter Bereinigen nicht verwalteter Ressourcen und Implementieren einer Dispose-Methode.