Graphics.Dispose Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Graphics.cs

Releases all resources used by this Graphics.

C#

public void Dispose();

Implements

Dispose()

Examples

The following code 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 from a graphics file SampImag.jpg in the example directory.

• Creates a Graphics from the Image.

• Alters the image by filling a rectangle within it.

• Draws the Image to the screen.

• Releases the created Graphics.

C#

private void FromImageImage1(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();
}

Remarks

Calling Dispose allows the resources used by this Graphics to be reallocated for other purposes.

Applies to