XmFontListRemoveEntry — A font list function that removes a font
list entry from a font list "XmFontListRemoveEntry" "font list
functions" "XmFontListRemoveEntry"
#include <Xm/Xm.h>
XmFontList XmFontListRemoveEntry(
XmFontList oldlist,
XmFontListEntry entry);
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
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.
XmFontList(3),
XmFontListAppendEntry(3),
XmFontListEntryCreate(3),
XmFontListEntryFree(3),
XmFontListEntryLoad(3), and
XmFontListFree(3).