Blitz3D+ Command Reference

HideGadget gadget

Parameters

gadget - gadget to hide

Description

Hides a gadget from view.

Requires Extended language mode.

Makes the gadget invisible without destroying anything - ShowGadget brings it back exactly as it was. A hidden gadget keeps its handle, text, shape and layout rules; it just is not drawn, cannot be clicked, and produces no events until shown again.

Hiding a container - a panel, group box or tabber page - takes everything inside it along, which is the standard way to build switchable tool modes: one panel of gadgets per mode, hide all but the active one. Hiding a window works too, taking it off screen and off the taskbar until shown again.

Use DisableGadget instead when the control should stay visible but greyed out - hiding is for things that do not apply right now, disabling for things that will in a moment. And note that freeing is different again: FreeGadget destroys, HideGadget only conceals.

The world editor shell sample shows the panelled layout this technique switches.

See also: ShowGadget, DisableGadget, EnableGadget, FreeGadget.

Index