KillControls

Dispose of all controls associated with a window

#include <Controls.h> Control Manager

void KillControls(theWindow );

WindowPtr theWindow ; window whose controls you wish to dispose

KillControls erases from the screen and removes from memory all controls

associated with a specified window.

theWindow is a pointer to a 108-byte GrafPort structure (actually a 156-byte

WindowRecord). It identifies the window you wish to purge of

controls.

Notes: The controlList field of each WindowRecord structure contains a

ControlHandle leading to a ControlRecord. The nextControl field of that

structure is a ControlHandle leading to another ControlRecord, and so forth.

KillControls reads down that chain of controls, disposing of each by

This function is used rarely since it is called automatically when close or

dispose the window (see CloseWindow and DisposeWindow).

Referenced by (7):