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

FreeBSD Manual Pages

  
 
  

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

NAME
     XmtChooserSetState(),  XmtChooserSetSensitive(), XmtChooserSetItemValue() -
     set the current selection in an XmtChooser widget, or  the  sensitivity  or
     value associated with its items.

SYNOPSIS
     #include <Xmt/Chooser.h>

     void XmtChooserSetState(Widget w, int state, Boolean notify)

     void XmtChooserSetSensitive(Widget w, int item, Boolean sensitive)

     void XmtChooserSetItemValue(Widget w, int item, XtPointer valuep)

ARGUMENTS
     INPUTS

	  w	 An XmtChooser widget.

	  state  The selection state to be set on the widget.

	  notify Whether the widget's XmtNvalueChangedCallback should be invoked
		 when the XmtChooser's state is changed. If True, the procedures
		 registered on that callback list will be called; if False, they
		 will not be called.

	  item	 The index of an item in the XmtChooser that is to have its sen-
		 sitivity or value set.

	  sensitive
		 True to make the item item in w sensitive, False to make it in-
		 sensitive.

	  valuep The address of the value to be associated with item item in w.

DESCRIPTION
     XmtChooserSetState()  sets the selection state state on the XmtChooser wid-
     get w, and updates the XmtChooser subwidgets to display the new  state.  If
     notify  is True, this function will invoke the procedures registered on the
     XmtChooser XmtNvalueChangedCallback list. Calling XmtChooserSetState() with
     notify False  is  equivalent  to,	but  more  efficient  than  setting  the
     XmtNstate resource of the widget.

     XmtChooserSetSensitive()  sets  the  sensitivity of a specified item, item,
     within the XmtChooser widget w. If sensitive is True,  then  the  specified
     item will be made sensitive. If sensitive is False, then the specified item
     will  be  made  insensitive.  Insensitive	items may not be selected by the
     user. In addition, for all XmtChooser types other than  XmtChooserRadioList
     and  XmtChooserCheckList,	insensitive  items  are  displayed with stippled
     (``greyed-out'') text, or with the special pixmaps specified in the XmtNin-
     sensitivePixmaps resource.

     XmtChooserSetItemValue() copies the value at address  specified  by  valuep
     into  an  internal array and associates it with item item of w. valuep must
     be a the address of a value which has the size specified  by  the	widget's
     XmtNvalueSize  resource.  It  is  usually	easier to specify values for all
     items by setting the XmtNvalues resource.

SEE ALSO
     Chapter 27, Presenting Choices,
     XmtChooser, XmtChooserLookupItemValue(), XmtChooserGetSensitivity(),
     XmtChooserGetState(), XmtChooserGetValue().

Xmt				   Motif Tools		   XmtChooserSetState(3)

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

home | help