<!-- $XConsortium: RendTaJ.sgm /main/8 1996/09/08 20:58:01 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.MAN363.rsml.1">
<RefMeta>
<RefEntryTitle>XmRenderTableRemoveRenditions</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmRenderTableRemoveRenditions</Function></RefName>
<RefPurpose>A convenience function that removes renditions
<IndexTerm>
<Primary>XmRenderTableRemoveRenditions</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>XmRenderTableRemoveRenditions</Function></FuncDef>
<!--<ParamDef><Replaceable>oldtable, tags, tag_count</Replaceable></ParamDef>-->
<ParamDef>XmRenderTable <Parameter>oldtable</Parameter></ParamDef>
<ParamDef>XmStringTag <Parameter>*tags</Parameter></ParamDef>
<ParamDef>int <Parameter>tag_count</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmRenderTableRemoveRenditions</Function> removes from <Symbol Role="Variable">oldtable</Symbol> the
renditions whose tags match the tags specified in <Symbol Role="Variable">tags</Symbol>, then
places the remaining renditions in a newly created render table.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">oldtable</Symbol></Term>
<ListItem>
<Para>Specifies the render table from which renditions are to be removed.
This function deallocates the original render table and the matching
renditions after extracting the required information.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">tags</Symbol></Term>
<ListItem>
<Para>Specifies an array of tags, whose corresponding renditions are to be
removed from <Symbol Role="Variable">oldtable</Symbol>.
</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>If <Symbol Role="Variable">oldtable</Symbol> or <Symbol Role="Variable">tags</Symbol> is NULL, or <Symbol Role="Variable">tag_count</Symbol> is 0
(zero), or no renditions are removed from <Symbol Role="Variable">oldtable</Symbol>, this
function returns <Symbol Role="Variable">oldtable</Symbol>. Otherwise, it returns a newly
allocated <StructName Role="typedef">XmRenderTable</StructName>.
The application is responsible for managing this allocated render table.
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-->
