Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Closing and Deallocating Windows

DisposeWindow

Use the DisposeWindow procedure to remove a window if you let the Window Manager allocate memory for the window record.

PROCEDURE DisposeWindow (theWindow: WindowPtr);

theWindow

A pointer to the window record of the window to be closed.

DESCRIPTION

The DisposeWindow procedure removes a window from the screen, deletes it from the window list, and releases the memory occupied by all structures associated with the window, including the window record. (DisposeWindow calls CloseWindow and then releases the memory occupied by the window record.)

WARNING

If your application allocated any other memory for use with a window, you must release it before calling DisposeWindow. The Window Manager releases only the data structures it created.

The DisposeWindow procedure assumes that any picture pointed to by the window record field windowPic is data, not a resource, and it calls the QuickDraw procedure KillPicture to delete it. If your application uses a picture stored as a resource, you must release the memory it occupies with the ReleaseResource procedure and set the windowPic field to NIL before closing the window.

Any pending update events for the window are discarded. If the window being removed is the frontmost window, the window behind it, if any, becomes the active window.