XmFontListRemoveEntry(library call) XmFontListRemoveEntry(library call)
NAME [Toc] [Back]
XmFontListRemoveEntry - A font list function that removes a font list
entry from a font list
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmFontList XmFontListRemoveEntry(
XmFontList oldlist,
XmFontListEntry entry);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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. If the function returns a new font list, the
function allocates space to hold the new font list. The application is
responsible for managing the allocated space. The application can
recover the allocated space by calling XmFontListFree.
RELATED [Toc] [Back]
XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryCreate(3),
XmFontListEntryFree(3), XmFontListEntryLoad(3), and XmFontListFree(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
