Museum

 XmFontListGetNextFont(Xm)      6 January 1993      XmFontListGetNextFont(Xm)


 Name

    XmFontListGetNextFont - a font list function that allows applications to
    access the fonts and character sets in a font list

 Syntax


    #include <Xm/Xm.h>

    Boolean XmFontListGetNextFont (context, charset, font)
    XmFontContext context;
    XmStringCharSet *charset;
    XFontStruct **font;


 Description

    XmFontListGetNextFont  accesses the character set and font for the next
    entry of the font list. The application first uses the XmFontListInit-
    FontContext routine to create a font list context.  The application then
    calls XmFontListGetNextFont repeatedly with the same context. Each
    succeeding call accesses the next element of the font list. When fin-
    ished, the application calls XmFontListFreeFontContext to free the
    allocated font list context.

    This routine allocates memory for the character set string that must be
    freed by the application.

    This function is obsolete and exists for compatibility with previous
    releases. It is replaced by XmFontListNextEntry.  If XmFontListGet-
    NextFont is passed a context that contains a font set entry, it will
    return the first font of the font set. The next call to the function will
    move to the next entry in the font list.

    context Specifies the font list context

    charset Specifies a pointer to a character set string; the routine
            returns the character set for the current font list element

    font    Specifies a pointer to a pointer to a font structure; the routine
            returns the font for the current font list element

 Return value

    Returns True if the returned values are valid; otherwise, returns False.

 See also

    XmFontList(Xm) and XmFontListNextEntry(Xm).