DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmFontListRemoveEntry(Xm)


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).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003