DisposeControl

Remove control from screen and free its memory

#include <Controls.h> Control Manager

void DisposeControl(theControl );

ControlHandle theControl ; handle of control to dispose

DisposeControl erases a control from the screen, releases memory

occupied by a ControlRecord structure, and removes the control from the

owning window's control list.

theControl is a handle leading to a variable length ControlRecord. It is a value

Notes: ControlRecords and ControlHandles are automatically disposed when their

owning window is disposed (see DisposeWindow).

The KillControls function disposes of all of a window's controls by

making multiple calls to this function.

If a control has an associated color table. it will be deleted unless it is a

resource. Also if the control has an associated non-default AuxRec, it will

be removed from memory as well.

Referenced by (13):