NAME

cxInWdgtDisable - disable a widget of a parameter port

C SPECIFICATION

#include <cx/UI.h>

void cxInWdgtDisable(char *portName)

FORTRAN SPECIFICATION

subroutine cxInWdgtDisable(portName)
character *(*) portName

PARAMETERS

portName: Name of the parameter port whose widget will be disabled.

DESCRIPTION

cxInWdgtDisable is an IRIS Explorer Widget Library call used within modules to disable a widget associated with a parameter. A disabled widget has a grayed-out appearance and does not respond to input events. Thus, the widget attached to the parameter port portName will be not operate after this call is made.

This routine and its companion, cxInWdgtEnable(3), can be used to make the appearance of module control panels context sensitive.

Advanced module writers occasionally create their own widget hierarchies using cxXtAreaInitialize() and cxXtAreaAttach(). Calling cxInWdgtDisable on the parameter associated with such a hierarchy will have no effect since the IRIS Explorer UI widget is unrelated (in a parent-child sense) to the user-created widget hierarchy.

It is an error to pass the function a portName that is not a parameter port with a widget.

KNOWN PROBLEMS

Some widgets, notably dials, have a very subtle gray-out effect. It is thus hard to notice that such widgets have been disabled.

Individual components of widgets can not be disabled (items in an option menu, for instance).

A bug can occur when the user is manipulating a widget while a module is disabling it. This bug has been observed in pushbuttons. The result is that the lighting effect that makes a button look pushed in is reversed. The state of the buttons lighting model remains reversed until the button is pushed again.