Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 5 - Control Manager / Control Manager Reference

Control Manager Routines / Removing Controls

DisposeControl

To remove a particular control from a window that you want to keep, use the DisposeControl procedure.

PROCEDURE DisposeControl (theControl: ControlHandle);

theControl

A handle to the control you wish to remove.

DESCRIPTION

The DisposeControl procedure removes the specified control from the screen, deletes it from its window's control list, and releases the memory occupied by the control record and any data structures associated with the control.

SPECIAL CONSIDERATIONS

The Window Manager procedures CloseWindow and DisposeWindow automatically dispose of all controls associated with the given window.

SEE ALSO

To remove all of the controls in a window, use the KillControls procedure, described next. The CloseWindow and DisposeWindow procedures are described in the chapter "Window Manager" in this book.