Region.Dispose Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Releases all resources used by this Region.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public void Dispose()

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

Call Dispose when you are finished using the Region. The Dispose method leaves the Region in an unusable state. After calling Dispose, you must release all references to the Region so the garbage collector can reclaim the memory that the Region was occupying. For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

System_CAPS_noteNote

Always call Dispose before you release your last reference to the Region. Otherwise, the resources it is using will not be freed until the garbage collector calls the Region object's Finalize method.

The following code example demonstrates the Region constructor and the Exclude and Dispose methods.

This example is designed to be used with Windows Forms. Paste the code into a form and call the FillRegionExcludingPath method when handling the form's Paint event, passing e as PaintEventArgs.

private void FillRegionExcludingPath(PaintEventArgs e)
{

    // Create the region using a rectangle.
    Region myRegion = new Region(new Rectangle(20, 20, 100, 100));

    // Create the GraphicsPath.
    System.Drawing.Drawing2D.GraphicsPath path = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25);

    // Exclude the circle from the region.
    myRegion.Exclude(path);

    // Retrieve a Graphics object from the form.
    Graphics formGraphics = e.Graphics;

    // Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion);

    // Dispose of the path and region objects.
    path.Dispose();
    myRegion.Dispose();

}

.NET Framework
Available since 1.1
Return to top
Show: