Museum

 XmFontListRemoveEntry(Xm)      6 January 1993      XmFontListRemoveEntry(Xm)


 Name

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

 Syntax


    #include <Xm/Xm.h>

    XmFontList XmFontListRemoveEntry (oldlist, entry)
    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 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.

 See also

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