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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmtSetValue(),  XmtSetTypedValue()  -  set a named widget resource to a
       named value.

SYNOPSIS
       #include	<Xmt/SetValue.h>

       void XmtSetValue(Widget w, String resource, String value)

       void XmtSetTypedValue(Widget w, String resource,	String type, String
		      value)

ARGUMENTS
       INPUTS

	    w	   The widget that is to have its resource set.

	    resource
		   The name of the resource to set.

	    type   For XmtSetTypedValue() only,	the representation type	of the
		   resource.

	    value  The value of	the resource, as  a  string.  These  functions
		   will	 automatically	convert	 the string to its appropriate
		   form.

DESCRIPTION
       XmtSetValue() and XmtSetTypedValue() are	procedures designed for	use in
       resource	 files	with  the Xmt String-to-Callback converter. They allow
       you to set a named widget resource to a value specified as a string.

       XmtSetValue() takes a widget, the name of a resource, and the value  of
       the resource, expressed as a string. It queries the widget to determine
       the type	of the named resource, converts	the specified string value  to
       that type, and then calls XtSetValues() to set the resource on the wid-
       get.

       XmtSetTypedValue() is a similar function, except	that it	takes  a  wid-
       get,  resource  name,  resource	type,  and  then  the  resource	 value
       expressed as a string. This version of the function  is	necessary  for
       those resources,	such as	the XmNvalue resource of the XmText widget (in
       Motif 1.1), that	are implemented	within subparts	of the widget,	rather
       than  as	 part  of  the	main  resource	list for the widget. For these
       resources, the type must	be specified  explicitly  because  Xmt	cannot
       determine the resource type by examining	the widget's internal resource
       list.

       For XmtSetTypedValue(), the resource type is a ``representation	type''
       such  as	 XtRString  or XtRInt.	The values of these symbolic constants
       are the strings ``String'' and ``Int''.	In general, there is  no  good
       way  to know when you need to use XmtSetTypedValue() instead of XmtSet-
       Value().	Your widget documentation might	tell you, or you might	see  a
       warning message when you	call XmtSetValue().

SEE ALSO
       Chapter 10, Callbacks in	Resource Files.

Xmt				  Motif	Tools			XmtSetValue(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmtSetValue&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help