XmFontListAdd (3) - Linux Manuals

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

Command to display XmFontListAdd manual in Linux: $ man 3 XmFontListAdd

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 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).