NAME
XmFontListNextEntry — A font list function that returns the next entry
in a font list
SYNOPSIS
#include <Xm/Xm.h>
XmFontListEntry XmFontListNextEntry(
XmFontContext context);
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.
context Specifies the font list context
RETURN
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.
If the function does return a font list entry, the font list entry is
not a copy. Therefore, the application should not free the returned
font list entry.
RELATED
XmFontList(3), XmFontListEntryFree(3), XmFontListEntryGetFont(3),
XmFontListEntryGetTag(3), XmFontListFreeFontContext(3), and
XmFontListInitFontContext(3).
XmFontListNextEntry(library call)