XmFontListRemoveEntry(3X) OSF XmFontListRemoveEntry(3X)
NAME
XmFontListRemoveEntry-A font list function that removes a
font list entry from a font list
SYNOPSIS
#include <Xm/Xm.h>
XmFontList XmFontListRemoveEntry (oldlist, entry)
XmFontList oldlist;
XmFontListEntryentry;
DESCRIPTION
XmFontListRemoveEntry creates a new font list that contains
the contents of oldlist minus those entries specified in
entry. The routine removes any entries from oldlist 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 XmFontListEntryFree to recover memory allocated for the
specified entry. This routine does not free the XFontSet or
XFontStruct associated with the font list entry that is
removed.
oldlistSpecifies the font list
entry Specifies the font list entry to be removed
RETURN VALUE
If oldlist is NULL, the function returns NULL. If entry is
NULL or no entries are removed, the function returns
oldlist. Otherwise, it returns a new font list.
RELATED INFORMATION
XmFontList(3X), XmFontListAppendEntry(3X),
XmFontListEntryCreate(3X), XmFontListEntryFree(3X),
XmFontListEntryLoad(3X), and XmFontListFree(3X).
1 (printed 6/8/92)