XmFontListAdd(3X) — DG/UX R4.11MU05



XmFontListAdd(3X)             SDK X11 R4.11MU05            XmFontListAdd(3X)


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

SYNOPSIS
       #include <Xm/Xm.h>

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


DESCRIPTION
       XmFontListAdd creates a new font list consisting of the contents of
       the oldlist and the new font-list element being added.  This function
       deallocates 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 character 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.

RELATED INFORMATION
       XmFontList(3X) and XmFontListAppendEntry(3X).


Licensed material--property of copyright holder(s)
Museum
