DisposeDialog

Close dialog and release all related memory

#include <Dialogs.h> Dialog Manager

void DisposDialog( theDialog );

DialogPtr theDialog ; dialog window to close

DisposDialog calls CloseDialog to close the dialog's window, remove it

from the screen, and release memory occupied by most types of items. It then

frees up memory occupied by the DialogRecord and the item list.

theDialog is the address of a 170-byte DialogRecord (however, the DialogPtr

data type is actually a WindowPtr, a.k.a cGrafPtr or GrafPtr). It

identifies the dialog to destroy.

Notes: As with CloseDialog, the window is removed from the screen and

appropriate update events are generated for other windows (see

CloseWindow). Storage is released for the dialog's window regions, item

handles; such as control records and text handles. Handles leading to icons

and pictures are NOT released.

Afterwards, DisposDialog goes on to release the DialogRecord and the

storage used to hold the item list.

Use DisposDialog to destroy dialogs created as heap objects (i.e., with

dStorage =NIL- see NewDialog or GetNewDialog). Use CloseDialog to

discard dialogs whose storage you allocated yourself (i.e., dStorage was an

address when the dialog was created).

Referenced by (11):