NAME

XmCvtStringToUnitType — a function that converts a string to a unit-type value.

SYNOPSIS

#include <Xm/Xm.h> void XmCvtStringToUnitType (args, num_args, from_val, to_val)
XrmValuePtr args;
Cardinal∗ num_args;
XrmValue∗ from_val;
XrmValue∗ to_val;

DESCRIPTION

XmCvtStringToUnitType converts a string to a unit type.  Refer to the man pages for XmGadget, XmManager, or XmPrimitive for a description of the valid unit types. 

Install this function as a resource converter using the Xt Intrinsics function XtAddConverter, rather than calling it directly.  The following code segment shows how to install the converter into the toolkit’s converter cache that will allow the resource XmNunitType to be specified through a resource file. 

XtAddConverter (XmRString, XmRUnitType, XmCvtStringToUnitType, NULL, 0);

This function should be installed only by applications that need to allow the unit type resource to be specified through a resource file.  It must be installed before any widget that is to have its XmNunitType resource set by data in a resource file is created. 

argsSpecifies a list of additional XrmValue arguments to the converter if additional context is needed to perform the conversion.  For example, the string-to-font converter needs the widget’s screen and the string-to-pixel converter needs the widget’s screen and color map.  This argument is often NULL. 

num_argsSpecifies the number of additional XrmValue arguments.  This argument is often zero. 

from_valSpecifies the value to convert

to_valSpecifies the descriptor to use to return the converted value

RELATED INFORMATION

XmGadget(3X), XmManager(3X), and XmPrimitive(3X). 

September 02, 1992