XmCvtStringToUnitType(3X) UNIX System V XmCvtStringToUnitType(3X)
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 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.
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
and the string-to-pixel converter needs the widget's screen and
color map. This argument is often NULL.
num_args
Specifies the number of additional XrmValue arguments. This
argument is often zero.
from_val
Specifies the value to convert
10/89 Page 1
XmCvtStringToUnitType(3X) UNIX System V XmCvtStringToUnitType(3X)
to_val Specifies the descriptor to use to return the converted value
RELATED INFORMATION
XmGadget(3X), XmManager(3X), and XmPrimitive(3X).
Page 2 10/89