NAME

       XmFontListNextEntry  —  A  font  list  function that returns the next entry in a font list
       "XmFontListNextEntry" "font list functions" "XmFontListNextEntry"

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(3)