Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XtSetSensitive(3)		  XT FUNCTIONS		       XtSetSensitive(3)

NAME
     XtSetSensitive, XtIsSensitive - set and check a widget's sensitivity state

SYNTAX
     #include <X11/Intrinsic.h>

     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 then recursively propagates the new value down the  man-
     aged  children  tree by calling XtSetValues on each child to set the ances-
     tor_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 and ancestor_sensi-
     tive.  Therefore, when one of these changes, the widget's set_values proce-
     dure should take whatever display actions are needed (for example,  greying
     out or stippling the widget).

     XtSetSensitive  maintains the invariant that if parent has either sensitive
     or ancestor_sensitive False,  then  all  children	have  ancestor_sensitive
     False.

     The XtIsSensitive function returns True or False to indicate whether or not
     user  input  events  are  being  dispatched.   If	both  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

X Version 11			   libXt 1.3.1		       XtSetSensitive(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XtIsSensitive&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help