XmFontListAdd — A font list function that creates a new font list
"XmFontListAdd" "font list functions"
"XmFontListAdd"
#include <Xm/Xm.h>
XmFontList XmFontListAdd(
XmFontList oldlist,
XFontStruct *font,
XmStringCharSet charset);
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.
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).