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 re-
		 source.

	  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 re-
     source  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 widget.

     XmtSetTypedValue()  is  a	similar function, except that it takes a widget,
     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 im-
     plemented within subparts of the widget, rather than as part  of  the  main
     resource  list for the widget. For these resources, the type must be speci-
     fied 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 XmtSetValue(). Your wid-
     get 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.1.quarterly>

home | help