XmCvtStringToUnitType(Xm) UNIX System V
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)
XrmValuePtrargs;
Cardinal * num_args;
XrmValue * from_val;
XrmValue * to_val;
DESCRIPTION
XmCvtStringToUnitType converts a string to a unit type.
Refer to 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 only be installed by applications which
need to allow the unit type resource to be specified through
a resource file. It must be installed before any widget is
created that is to have its XmNunitType resource set by data
in a resource file.
args Specifies 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, or the
string-to-pixel converter needs the widget's screen
and color map. This argument if often NULL.
num_args
Specifies the number of additional XrmValue
arguments. This argument is often zero.
from_val
Specifies the value to convert.
to_val Specifies the descriptor to use to return the
converted value.
RELATED INFORMATION
XmGadget(Xm), XmManager(Xm), and XmPrimitive(Xm).
(printed 2/14/90) XmCvtStringToUnitType(Xm)