XmFontListAppendEntry(X3mot)

XmFontListAppendEntry -- a font list function that appends an entry to a font list

Synopsis

#include <Xm/Xm.h>

XmFontList XmFontListAppendEntry (oldlist, entry)
XmFontList oldlist;
XmFontListEntry entry;

Description

XmFontListAppendEntry creates a new font list that contains the contents of oldlist. This function copies the contents of the font list entry being added into this new font list. If oldlist is NULL, XmFontListAppendEntry creates a new font list containing only the single entry specified.

This function deallocates the original font list after extracting the required information. The caller must free the font list entry by using XmFontListEntryFree.

oldlist: Specifies the font list to be added to
entry: Specifies the font list entry to be added

Return values

If entry is NULL, returns oldlist; otherwise, returns a new font list.

References

XmFontList(X3mot), XmFontListEntryCreate(X3mot), XmFontListEntryFree(X3mot), XmFontListEntryLoad(X3mot), XmFontListFree(X3mot) and XmFontListRemoveEntry(X3mot).