Inside Macintosh: Imaging With QuickDraw /

Chapter 5 - Graphics Devices / Graphics Devices Reference

Routines for Graphics Devices / Creating, Setting, and Disposing of GDevice Records

DisposeGDevice

Although your application generally should never need to use this routine, the DisposeGDevice procedure disposes of a GDevice record, releases the space allocated for it, and disposes of all the data structures allocated for it. The DisposeGDevice procedure is also available as the DisposGDevice procedure.

PROCEDURE DisposeGDevice (gdh: GDHandle);

gdh

A handle to the GDevice record.

DESCRIPTION

The DisposeGDevice procedure disposes of a GDevice record, releases the space allocated for it, and disposes of all the data structures allocated for it. Color QuickDraw calls this procedure when appropriate.

SEE ALSO

When your application uses the DisposeGWorld procedure to dispose of an offscreen graphics world, DisposeGDevice disposes of its GDevice record. See the chapter "Offscreen Graphics Worlds" in this book for a description of DisposeGWorld.