<!-- $XConsortium: RendD.sgm /main/7 1996/08/30 15:57:11 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.MAN367.rsml.1">
<RefMeta>
<RefEntryTitle>XmRenditionRetrieve</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmRenditionRetrieve</Function></RefName>
<RefPurpose>A convenience function that retrieves rendition resources
<IndexTerm>
<Primary>XmRenditionRetrieve</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>void <Function>XmRenditionRetrieve</Function></FuncDef>
<!--<ParamDef><Replaceable>rendition, arglist, argcount</Replaceable></ParamDef>-->
<ParamDef>XmRendition <Parameter>rendition</Parameter></ParamDef>
<ParamDef>ArgList <Parameter>arglist</Parameter></ParamDef>
<ParamDef>Cardinal <Parameter>argcount</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmRenditionRetrieve</Function> extracts values for the given resources
(<Symbol Role="Variable">arglist</Symbol>) from the specified rendition.
Note that the function returns the actual values of the resources, not
copies. Therefore it is necessary to copy before modifying any
resource whose value is an address. This will include such resources
as <SystemItem Class="Resource">XmNfontName</SystemItem>, <SystemItem Class="Resource">XmNfont</SystemItem>, and <SystemItem Class="Resource">XmNtabList</SystemItem>.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">rendition</Symbol></Term>
<ListItem>
<Para>Specifies the rendition.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">arglist</Symbol></Term>
<ListItem>
<Para>Specifies the argument list.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">argcount</Symbol></Term>
<ListItem>
<Para>Specifies the number of attribute/value pairs in the argument list
(<Symbol Role="Variable">arglist</Symbol>).
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmRendition;
and
&cdeman.XmTabListCopy;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
