<!-- $XConsortium: CvtStr.sgm /main/10 1996/09/08 20:37:40 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN191.rsml.1">
<RefMeta>
<RefEntryTitle>XmCvtStringToUnitType</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmCvtStringToUnitType</Function></RefName>
<RefPurpose>A function that converts a string to a unit-type value
<IndexTerm>
<Primary>XmCvtStringToUnitType</Primary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/Xm.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmCvtStringToUnitType</Function></FuncDef>
<!--<ParamDef><Replaceable>args, num_args, from_val, to_val</Replaceable></ParamDef>-->
<ParamDef>XrmValuePtr <Parameter>args</Parameter></ParamDef>
<ParamDef>Cardinal <Parameter>* num_args</Parameter></ParamDef>
<ParamDef>XrmValue <Parameter>* from_val</Parameter></ParamDef>
<ParamDef>XrmValue <Parameter>* to_val</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmCvtStringToUnitType</Function> converts a string to a unit type. Refer to
the reference pages for <Classname>XmGadget</Classname>,
<Classname>XmManager</Classname>, or <Classname>XmPrimitive</Classname> for a
description of the valid unit types.
Use of this function as a resource converter is obsolete. It has been replaced
by a new resource converter that uses the RepType facility.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">args</Symbol></Term>
<ListItem>
<Para>Specifies a list of additional <Symbol>XrmValue</Symbol> 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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">num_args</Symbol></Term>
<ListItem>
<Para>Specifies the number of additional <Symbol>XrmValue</Symbol> arguments. This argument
is often zero.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">from_val</Symbol></Term>
<ListItem>
<Para>Specifies the value to convert
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">to_val</Symbol></Term>
<ListItem>
<Para>Specifies the descriptor to use to return the converted value
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmGadget;, &cdeman.XmManager;, and &cdeman.XmPrimitive;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
