XT FUNCTIONS XtSetSensitive(3xt)
NAME
XtSetSensitive, XtIsSensitive - set and check a widget's
sensitivity state SYNTAXcc [ flag... ] file... -lXt [ library... ]
void XtSetSensitive(Widget w, Boolean sensitive);Boolean XtIsSensitive(Widget w);
ARGUMENTS sensitive Specifies a Boolean value that indicates whether the widget should receive keyboard and pointer events. w Specifies the widget.DESCRIPTION
The XtSetSensitive function first calls XtSetValues on the current widget with an argument list specifying that the sensitive field should change to the new value. It thenrecursively propagates the new value down the managed chil-
dren tree by calling XtSetValues on each child to set theancestor_sensitive to the new value if the new values for
sensitive and the child's ancestor_sensitive are not the
same. XtSetSensitive calls XtSetValues to change sensitive andancestor_sensitive. Therefore, when one of these changes,
the widget's set_values procedure should take whatever
display actions are needed (for example, greying out or stippling the widget). XtSetSensitive maintains the invariant that if parent haseither sensitive or ancestor_sensitive False, then all chil-
dren have ancestor_sensitive False.
The XtIsSensitive function returns True or False to indicate
whether or not user input events are being dispatched. Ifboth core.sensitive and core.ancestor_sensitive are True,
XtIsSensitive returns True; otherwise, it returns False.
SEE ALSO
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes: X Version 11 Last change: libXt 1.0.8 1 XT FUNCTIONS XtSetSensitive(3xt)__________________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|___________________________________|
| Availability | x11/library/toolkit/libxt ||_____________________________|___________________________________|
| Interface Stability | Committed ||_____________________________|___________________________________|
| MT-Level | See XtToolkitThreadInitialize(3XT)|
|_____________________________|___________________________________|
X Version 11 Last change: libXt 1.0.8 2