Disabling Controls

FUNCTIONS

  void  enable(Control *c);
  void  disable(Control *c);
  int   is_enabled(Control *c);

NOTES

A control can be enabled so it can receive user input and mouse clicks, or disabled so that it cannot.

To enable a control to receive user input and mouse clicks, call the enable function. By default, when a control is created, it is always enabled. However, this function can re-enable a control which has been disabled.

To disable a control, and make it ignore user input, use disable. A disabled control will usually have grey text, and will not respond to the user. An exception to this is a disabled textbox or field, which will appear normal, but cannot be edited or modified by the user.

The is_enabled function will return zero if the control is disabled, and one if it is enabled.