Museum

 XmFontListNextEntry(Xm)        6 January 1993        XmFontListNextEntry(Xm)


 Name

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

 Syntax


    #include <Xm/Xm.h>

    XmFontListEntry XmFontListNextEntry (context)
    XmFontContext context;


 Description

    XmFontListNextEntry returns the next entry in the font list. The applica-
    tion 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 XmFontListNex-
    tEntry 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 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.

 See also

    XmFontList(Xm), XmFontListEntryFree(Xm), XmFontListEntryGetFont(Xm),
    XmFontListEntryGetTag(Xm), XmFontListFreeFontContext(Xm) and
    XmFontListInitFontContext(Xm).