XmFontListNextEntry(library call)            XmFontListNextEntry(library call)

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)