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

FreeBSD Manual Pages

  
 
  

home | help
XmtChooserGetState(3)	   Library Functions Manual	 XmtChooserGetState(3)

NAME
       XmtChooserGetState(),  XmtChooserGetValue(), XmtChooserGetSensitivity()
       - query an XmtChooser widget about its selected items and  item	sensi-
       tivity.

SYNOPSIS
       #include	<Xmt/Chooser.h>

       int XmtChooserGetState(Widget w)

       XtPointer XmtChooserGetValue(Widget w)

       Boolean XmtChooserGetSensitivity(Widget w, int item)

ARGUMENTS
       INPUTS

	    w	   An XmtChooser widget.

	    item   The index of	an item	within w.

       RETURNS

	    See	below.

DESCRIPTION
       XmtChooserGetState() returns the	selection state	of the XmtChooser wid-
       get  w.	If the XmtNchooserType resource	of the widget is XmtChooserRa-
       dioBox, XmtChooserRadioPalette, XmtChooserRadioList,  or	 XmtChooserOp-
       tion, then the returned value is	the index of the single	selected item.
       If the XmtNchooserType resource is XmtChooserCheckBox, XmtChooserCheck-
       Palette,	 or XmtChooserCheckList, then the returned value is a bitfield
       indicating the selection	state of each of the items (up to 32)  in  the
       widget.	If  the	 XmtNchooserType resource is XmtChooserButtonBox, then
       the returned value is not meaning ful. Calling this function is equiva-
       lent to,	but more efficient than, querying the XmtNstate	resource of w.

       XmtChooserGetValue() returns the	address	of the value associated
	with the selected item in the XmtChooser w. The	specified widget  must
       have  its  XmtNchooserType  resource  set to one	of the ``single	selec-
       tion'' types: XmtChooserRadioBox, XmtChooserRadioPalette, XmtChooserRa-
       dioList,	or XmtChooserOption.  Note  that  the  returned	 value	is  an
       untyped pointer.	 You must cast and dereference it as appropriate.

       XmtChooserGetSensitivity()  return True if item item in XmtChooser w is
       sensitive, and False otherwise. Use XmtChooser  SetSensitive()  to  set
       the sensitivity of an item. Insensitive items cannot be selected	by the
       user.

SEE ALSO
       Chapter 27, Presenting Choices,
       XmtChooser, XmtChooserSetState(), XmtChooserSetItemValue(),
       XmtChooserSetSensitive().

Xmt				  Motif	Tools		 XmtChooserGetState(3)

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

home | help