<!-- $XConsortium: RendTaE.sgm /main/7 1996/08/30 15:58:32 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.MAN358.rsml.1">
<RefMeta>
<RefEntryTitle>XmRenderTableCvtToProp</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmRenderTableCvtToProp</Function></RefName>
<RefPurpose>A render table function that converts a render table to a string representation
<IndexTerm>
<Primary>XmRenderTableCvtToProp</Primary>
</IndexTerm><IndexTerm>
<Primary>render table functions</Primary>
<Secondary>XmRenderTableCvtToProp</Secondary>
</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-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/Xm.h>
</FuncSynopsisInfo>
<FuncDef>unsigned int <Function>XmRenderTableCvtToProp</Function></FuncDef>
<!--<ParamDef><Replaceable>widget, table, prop_return</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>XmRenderTable <Parameter>table</Parameter></ParamDef>
<ParamDef>char **<Parameter>prop_return</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmRenderTableCvtToProp</Function> converts a render table to a string of
characters representing the render table.
This routine is typically used by the source of a data transfer
operation to produce a representation for transferring a render table to
a destination.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">widget</Symbol></Term>
<ListItem>
<Para>Specifies the widget that is the source of the render table
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">table</Symbol></Term>
<ListItem>
<Para>Specifies a render table to be converted
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">prop_return</Symbol></Term>
<ListItem>
<Para>Specifies a pointer to a string that is created and returned by this
function.
The function allocates space to hold the returned string.
The application is responsible for managing this allocated space.
The application can recover this allocated space by calling <Function>XtFree</Function>.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>Returns the number of bytes in the string representation.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmRenderTable; and
&cdeman.XmRenderTableCvtFromProp;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
