XmFontListRemoveEntry(library call) XmFontListRemoveEntry(library call)

NAME

XmFontListRemoveEntry -- A font list function that removes a font
list entry from a font list

SYNOPSIS

#include <Xm/Xm.h>
XmFontList XmFontListRemoveEntry(
XmFontList oldlist,
XmFontListEntry entry);

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.

oldlist Specifies the font list

entry Specifies the font list entry to be removed

RETURN

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. 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
XmFontListFree.

RELATED

XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryCreate(3),
XmFontListEntryFree(3), XmFontListEntryLoad(3), and
XmFontListFree(3).

XmFontListRemoveEntry(library call)