Museum

 XmFontListAdd(Xm)              6 January 1993              XmFontListAdd(Xm)


 Name

    XmFontListAdd - a font list function that creates a new font list

 Syntax


    #include <Xm/Xm.h>

    XmFontList XmFontListAdd (oldlist, font, charset)
    XmFontList oldlist;
    XFontStruct *font;
    XmStringCharSet charset;


 Description

    XmFontListAdd creates a new font list consisting of the contents of the
    oldlist and the new font-list element being added. This function deallo-
    cates the oldlist after extracting the required information; therefore,
    do not reference oldlist thereafter.

    _________________________________________________________________________
       NOTE  This function is obsolete and exists for compatibility with
       previous releases. It has been replaced by XmFontListAppendEntry.
    _________________________________________________________________________


    oldlist Specifies a pointer to the font list to which an entry will be
            added.

    font    Specifies a pointer to a font structure for which the new font
            list is generated. This is the structure returned by the XLib
            XLoadQueryFont function.

    charset Specifies the character set identifier for the font.  This can be
            XmSTRINGDEFAULTCHARSET, but this value does not comply with the
            AES, and it may be removed in future versions of Motif.  If the
            value is XmSTRINGDEFAULTCHARSET, the routine derives the char-
            acter set from the current language environment.

 Return value

    Returns NULL if oldlist is NULL; returns oldlist if font or charset is
    NULL; otherwise, returns a new font list.

 See also

    XmFontList(Xm) and XmFontListAppendEntry(Xm).