Museum

 XmFontListCreate(Xm)           6 January 1993           XmFontListCreate(Xm)


 Name

    XmFontListCreate - a font list function that creates a font list

 Syntax


    #include <Xm/Xm.h>

    XmFontList XmFontListCreate (font, charset)
    XFontStruct * font;
    XmStringCharSet charset;


 Description

    XmFontListCreate creates a new font list with a single element specified
    by the provided font and character set. It also allocates the space for
    the font list.

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

    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 font or charset is NULL; otherwise, returns a new font
    list.

 See also

    XmFontList(Xm) and XmFontListAppendEntry(Xm).