XmFontListAdd(library call)                     XmFontListAdd(library call)




 NAME    [Toc]    [Back]
      XmFontListAdd - A font list function that creates a new font list

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/Xm.h>
      XmFontList XmFontListAdd(
      XmFontList oldlist,
      XFontStruct *font,
      XmStringCharSet charset);

 DESCRIPTION    [Toc]    [Back]
      XmFontListAdd creates a new font list consisting of the contents of
      oldlist and the new font list element being added. This function
      deallocates 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 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    [Toc]    [Back]
      Returns NULL if oldlist is NULL; returns oldlist if font or charset is
      NULL; otherwise, returns a new font list.

 RELATED    [Toc]    [Back]
      XmFontList(3) and XmFontListAppendEntry(3).


                                    - 1 -       Formatted:  January 24, 2005