XmFontListAdd(3X)
Prev | Reference Pages | Next

## Name

XmFontListAdd(3X) — XmFontListAdd--A font list function that creates a new font list XmFontListAddfont list functions

## Synopsis

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

## DESCRIPTION

XmFontListAdd creates a new font list consisting of the contents of the `oldlist` and the new font-list element being added. This function deallocates the `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 VALUE

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

## RELATED INFORMATION

XmFontList(3X) and XmFontListAppendEntry(3X).

Prev | Table of Contents | Next
XmFontList(3X) |  | XmFontListAppendEntry(3X)