Graphics.Dispose Method
Releases all resources used by this Graphics object.
[Visual Basic] Public Overridable Sub Dispose() Implements IDisposable.Dispose [C#] public virtual void Dispose(); [C++] public: virtual void Dispose(); [JScript] public function Dispose();
Return Value
This method does not return a value.
Implements
Remarks
Calling Dispose allows the resources used by this Graphics object to be reallocated for other purposes.
Example
[Visual Basic, C#] The following example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:
- Creates an Image object from a graphics file SampImag.jpg in the example directory.
- Creates a Graphics object from the Image object.
- Alters the image by filling a rectangle within it.
- Draws the Image object to the screen.
- Releases the created Graphics object.
[Visual Basic] Public Sub FromImageImage(e As PaintEventArgs) ' Create image. Dim imageFile As Image = Image.FromFile("SampImag.jpg") ' Create graphics object for alteration. Dim newGraphics As Graphics = Graphics.FromImage(imageFile) ' Alter image. newGraphics.FillRectangle(New SolidBrush(Color.Black), 100, _ 50, 100, 100) ' Draw image to screen. e.Graphics.DrawImage(imageFile, New PointF(0F, 0F)) ' Dispose of graphics object. newGraphics.Dispose() End Sub [C#] public void FromImageImage(PaintEventArgs e) { // Create image. Image imageFile = Image.FromFile("SampImag.jpg"); // Create graphics object for alteration. Graphics newGraphics = Graphics.FromImage(imageFile); // Alter image. newGraphics.FillRectangle(new SolidBrush(Color.Black), 100, 50, 100, 100); // Draw image to screen. e.Graphics.DrawImage(imageFile, new PointF(0.0F, 0.0F)); // Release graphics object. newGraphics.Dispose(); }
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework
See Also
Graphics Class | Graphics Members | System.Drawing Namespace