<!-- $XConsortium: RendTaC.sgm /main/8 1996/09/08 20:57:28 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.MAN356.rsml.1">
<RefMeta>
<RefEntryTitle>XmRenderTableCopy</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmRenderTableCopy</Function></RefName>
<RefPurpose>A render table function that copies renditions
<IndexTerm>
<Primary>XmRenderTableCopy</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-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/Xm.h>
</FuncSynopsisInfo>
<FuncDef>XmRenderTable <Function>XmRenderTableCopy</Function></FuncDef>
<!--<ParamDef><Replaceable>table, tags, tag_count</Replaceable></ParamDef>-->
<ParamDef>XmRenderTable <Parameter>table</Parameter></ParamDef>
<ParamDef>XmStringTag <Parameter>*tags</Parameter></ParamDef>
<ParamDef>int <Parameter>tag_count</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmRenderTableCopy</Function> creates a new render table
which will contain
the renditions of the <Symbol Role="Variable">table</Symbol> whose tags match those in <Symbol Role="Variable">tags</Symbol>.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">table</Symbol></Term>
<ListItem>
<Para>Specifies the table containing the renditions to be copied.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">tags</Symbol></Term>
<ListItem>
<Para>Specifies an array of tags, whose corresponding renditions are to be
copied. NULL indicates that the complete table should be copied.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">tag_count</Symbol></Term>
<ListItem>
<Para>Specifies the number of tags in <Symbol Role="Variable">tags</Symbol>.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>Returns NULL if <Symbol Role="Variable">table</Symbol> is NULL. Otherwise, this function returns
the new render table.
This function allocates space to hold the new render table.
The application is responsible for managing this allocated space.
The application can recover this allocated space by calling <Function>XmRenderTableFree</Function>.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmRendition; and
&cdeman.XmRenderTableFree;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
