XmFontListNextEntry(3X)

     NAME
          XmFontListNextEntry - A font list function that returns the
          next entry in a font list

     SYNOPSIS
          #include <Xm/Xm.h>
          XmFontListEntry XmFontListNextEntry(
          XmFontContext context);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmFontListNextEntry returns the next entry in the font list.
          The application uses the XmFontListInitFontContextroutine 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
          XmFontListNextEntryrepeatedly 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).