XmFontListRemoveEntry(3X)
Prev | Reference Pages | Next

## Name

XmFontListRemoveEntry(3X) — XmFontListRemoveEntry--A font list function that removes a font list entry from a font list XmFontListRemoveEntryfont list functions

## Synopsis

#include <Xm/Xm.h>
XmFontList XmFontListRemoveEntry (`oldlist, entry`)
XmFontList `oldlist`;
XmFontListEntry `entry`;

## DESCRIPTION

XmFontListRemoveEntry creates a new font list that contains the contents of `oldlist` minus those entries specified in `entry`. The routine removes any entries from `oldlist` that match the components (tag, type font/font set) of the specified entry. The function deallocates the original font list after extracting the required information. The caller uses XmFontListEntryFree to recover memory allocated for the specified entry. This routine does not free the XFontSet or XFontStruct associated with the font list entry that is removed.

`oldlist` |  | Specifies the font list
`entry` |  | Specifies the font list entry to be removed

## RETURN VALUE

If `oldlist` is NULL, the function returns NULL. If `entry` is NULL or no entries are removed, the function returns `oldlist`. Otherwise, it returns a new font list.

## RELATED INFORMATION

XmFontList(3X), XmFontListAppendEntry(3X), XmFontListEntryCreate(3X), XmFontListEntryFree(3X), XmFontListEntryLoad(3X), and XmFontListFree(3X).

Prev | Table of Contents | Next
XmFontListNextEntry(3X) |  | XmForm(3X)