noble (3) XmFontListAdd.3.gz

Provided by: libmotif-dev_2.3.8-3.1build1_amd64 bug

NAME
       XmFontListAdd  —  A font list function that creates a new font list "XmFontListAdd" "font list functions"
       "XmFontListAdd"


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


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


       XmFontList(3) and XmFontListAppendEntry(3).

                                                                                                XmFontListAdd(3)