manpagez: man pages & more
man XmFontListAdd(3)
Home | html | info | man
XmFontListAdd(library call)                        XmFontListAdd(library call)




NAME

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


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  deal-
       locates  oldlist  after extracting the required information; therefore,
       do not reference oldlist thereafter.

       NOTE: This function is obsolete and exists for compatibility with  pre-
       vious 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 com-
                 ply 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  environ-
                 ment.


RETURN

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


RELATED

       XmFontList(3) and XmFontListAppendEntry(3).



                                                   XmFontListAdd(library call)

openMotif 2.3.1 - Generated Sun Nov 30 14:03:28 CST 2008
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.