<!-- $XConsortium: FontLstO.sgm /main/8 1996/09/08 20:44:07 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.MAN235.rsml.1">
<RefMeta>
<RefEntryTitle>XmFontListEntryGetTag</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmFontListEntryGetTag</Function></RefName>
<RefPurpose>A font list function that
retrieves the tag of a font list entry
<IndexTerm>
<Primary>XmFontListEntryGetTag</Primary>
</IndexTerm><IndexTerm>
<Primary>font list functions</Primary>
<Secondary>XmFontListEntryGetTag</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-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (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>char* <Function>XmFontListEntryGetTag</Function></FuncDef>
<!--<ParamDef><Replaceable>entry</Replaceable></ParamDef>-->
<ParamDef>XmFontListEntry <Parameter>entry</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmFontListEntryGetTag</Function> retrieves a copy of the tag of the specified
font list entry. This routine allocates memory for the tag string that
must be freed by the application.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">entry</Symbol></Term>
<ListItem>
<Para>Specifies the font list entry
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>Returns the tag for the font list entry.
The function allocates space to hold the returned tag.
The application is responsible for managing the allocated space.
The application can recover the allocated space by calling <Function>XtFree</Function>.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmFontList;,
&cdeman.XmFontListEntryCreate;,
&cdeman.XmFontListEntryGetFont;,
&cdeman.XmFontListEntryLoad;, and
&cdeman.XmFontListNextEntry;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
