<!-- $XConsortium: FontLstW.sgm /main/9 1996/09/08 20:44:51 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.MAN242.rsml.1">
<RefMeta>
<RefEntryTitle>XmFontListRemoveEntry</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmFontListRemoveEntry</Function></RefName>
<RefPurpose>A font list function that removes a font list entry from a font list
<IndexTerm>
<Primary>XmFontListRemoveEntry</Primary>
</IndexTerm><IndexTerm>
<Primary>font list functions</Primary>
<Secondary>XmFontListRemoveEntry</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>XmFontList <Function>XmFontListRemoveEntry</Function></FuncDef>
<!--<ParamDef><Replaceable>oldlist, entry</Replaceable></ParamDef>-->
<ParamDef>XmFontList <Parameter>oldlist</Parameter></ParamDef>
<ParamDef>XmFontListEntry <Parameter>entry</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmFontListRemoveEntry</Function> creates a new font list
that contains the contents of <Symbol Role="Variable">oldlist</Symbol>
minus those entries specified in <Symbol Role="Variable">entry</Symbol>.
The routine removes any entries from <Symbol Role="Variable">oldlist</Symbol>
that match the components (tag, type font/font set)
of the specified entry. The function deallocates the
original font list after extracting the required
information. The caller uses <Function>XmFontListEntryFree</Function>
to recover memory allocated for the specified entry. This
routine does not free the <Symbol>XFontSet</Symbol> or <Symbol>XFontStruct</Symbol> associated
with the font list entry that is removed.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">oldlist</Symbol></Term>
<ListItem>
<Para>Specifies the font list
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">entry</Symbol></Term>
<ListItem>
<Para>Specifies the font list entry to be removed
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>If <Symbol Role="Variable">oldlist</Symbol> is NULL, the function returns NULL. If
<Symbol Role="Variable">entry</Symbol> is NULL or no entries are removed, the function
returns <Symbol Role="Variable">oldlist</Symbol>. Otherwise, it returns a new font list.
If the function returns a new font list, the function allocates
space to hold the new font list. The application is responsible
for managing the allocated space. The application can recover the
allocated space by calling <Function>XmFontListFree</Function>.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmFontList;,
&cdeman.XmFontListAppendEntry;,
&cdeman.XmFontListEntryCreate;,
&cdeman.XmFontListEntryFree;,
&cdeman.XmFontListEntryLoad;, and
&cdeman.XmFontListFree;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
