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).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004