Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Imaging With QuickDraw /

Chapter 3 - QuickDraw Drawing / QuickDraw Drawing Reference

Routines / Creating and Managing Regions

DisposeRgn
To release the memory occupied by a region, use the DisposeRgn procedure.
PROCEDURE DisposeRgn (rgn:\xDDRgnHandle);
rgn
A handle to the region to dispose.

DESCRIPTION
The DisposeRgn procedure releases the memory occupied by the region whose handle you pass in the rgn parameter.
Use DisposeRgn only after you're completely through with a region.

SPECIAL CONSIDERATIONS
The DisposeRgn procedure may move or purge memory blocks in the application heap. Your application should not call this procedure at interrupt time.

SEE ALSO
Listing 3-8 on page 3-24 and Listing 3-9 on page 3-25 illustrate how to use this procedure.