XmFontListNextEntry(3X) OSF XmFontListNextEntry(3X)
NAME
XmFontListNextEntry-A font list function that returns the
next entry in a font list
SYNOPSIS
#include <Xm/Xm.h>
XmFontListEntry XmFontListNextEntry (context)
XmFontContextcontext;
DESCRIPTION
XmFontListNextEntry returns the next entry in the font list.
The application uses the XmFontListInitFontContext routine
to create a font list context. The first call to
XmFontListNextEntry sets the context to the first entry in
the font list. The application then calls
XmFontListNextEntry repeatedly with the same context. Each
succeeding call accesses the next entry of the font list.
When finished, the application calls
XmFontListFreeFontContext to free the allocated font list
context.
contextSpecifies the font list context
RETURN VALUE
Returns NULL if the context does not refer to a valid entry
or if it is at the end of the font list; otherwise, it
returns a font list entry.
RELATED INFORMATION
XmFontList(3X), XmFontListEntryFree(3X),
XmFontListEntryGetFont(3X), XmFontListEntryGetTag(3X),
XmFontListFreeFontContext(3X), and
XmFontListInitFontContext(3X).
1 (printed 6/8/92)