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)

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

home | help