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;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmFontListNextEntry  returns the next entry in the font list.  The applica-
     tion uses the XmFontListInitFontContext routine to create a font list  con-
     text.   The first call to XmFontListNextEntry sets the context to the first
     entry in the font list.  The application then calls XmFontListNextEntry re-
     peatedly with the same context.  Each succeeding call accesses the next en-
     try of the font list.  When finished, the application calls XmFontListFree-
     FontContext 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), Xm-
     FontListEntryGetTag(3X), XmFontListFreeFontContext(3X), and XmFontListInit-
     FontContext(3X).

                                                         XmFontListNextEntry(3X)