NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

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

DESCRIPTION    [Toc]    [Back]

       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.

       Specifies a pointer to the font list  to  which  an  entry
       will  be  added.   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.
       Specifies the character set identifier for the font.  This
       can  be  XmSTRING_DEFAULT_CHARSET, but this value does not
       comply with the AES, and it may be removed in future  versions
  of Motif. If the value is XmSTRING_DEFAULT_CHARSET,
       the routine derives the character  set  from  the  current
       language environment.

RETURN VALUE    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       XmFontList(3X), XmFontListAppendEntry(3X)



                                                XmFontListAdd(3X)