HideControl

Erase a control and make it in visible

#include <Controls.h> Control Manager

void HideControl(theControl );

ControlHandle theControl ; control to hide

HideControl erases a control by filling its contrlRect with the owning

window's background pattern. The enclosing rectangle is also added to the

window's update region. The control will not be drawn by subsequent calls to

theControl is a handle leading to a variable-length ControlRecord structure. It

identifies which control you wish to hide.

Notes: HideControl sets the contrlVis field of the ControlRecord to 0 and makes

it inactive. Use ShowControl to set contrlVis to 255 and cause the control

to be redrawn. We are expressly warned against storing values directly

into the contrlVis field.

functions will not draw theControl.

Rather than removing a temporarily unwanted control, the normal action

is to use HiliteControl(...,0) to dim it. This is in keeping with the Mac

strategy of not moving things around unnecessarily.

Referenced by (9):