OSF/Motif

NAME

XmFontListAppendEntry − A font list function that appends an entry to a font list

SYNOPSIS

#include <Xm/Xm.h>
XmFontList XmFontListAppendEntry (oldlist, entry)
XmFontListoldlist;
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. 

oldlistSpecifies the font list to be added to

entrySpecifies the font list entry to be added

RETURN VALUE

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

RELATED INFORMATION

XmFontList(3X), XmFontListEntryCreate(3X), XmFontListEntryFree(3X), XmFontListEntryLoad(3X), XmFontListFree(3X), and XmFontListRemoveEntry(3X).