XmCvtStringToUnitType(3Xm)

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 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(3Xm), XmManager(3Xm), and XmPrimitive(3Xm).