XmFontListRemoveEntry(3X) — DG/UX R4.11MU05



XmFontListRemoveEntry(3X)     SDK X11 R4.11MU05    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.


        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.

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


Licensed material--property of copyright holder(s)
Museum
