Pen.Dispose Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwalnia wszystkie zasoby używane przez ten Penprogram .
public:
virtual void Dispose();
public void Dispose();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()
Implementuje
Przykłady
W poniższym przykładzie kodu pokazano efekty ustawiania Width właściwości i LineJoin oraz pokazano, jak wywołać Dispose metodę dla elementu Pen.
Ten przykład został zaprojektowany do użycia z formularzami systemu Windows. Wklej kod do formularza i wywołaj ShowLineJoin metodę podczas obsługi zdarzenia formularza Paint , przekazując e jako 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
Uwagi
Wywołanie Dispose umożliwia przeniesienie zasobów używanych przez tę Brush funkcję do innych celów.
Wywołaj metodę Dispose po zakończeniu korzystania z elementu Pen. Metoda Dispose pozostawia Pen w stanie bezużytecznym. Po wywołaniu metody Disposenależy zwolnić wszystkie odwołania do Pen modułu , aby moduł odśmiecania pamięci mógł odzyskać pamięć zajmowaną przez Pen element . Aby uzyskać więcej informacji, zobacz Oczyszczanie zasobów niezarządzanych i Implementowanie metody Dispose.
Note
Przed wydaniem ostatniego odwołania do elementu należy zawsze wywołać metodę DisposePen. W przeciwnym razie zasoby, których używasz, nie zostaną zwolnione, dopóki moduł odśmiecający elementy bezużyteczne wywoła Pen metodę obiektu Finalize .