Legacy Document

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

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.