XmFontListGetNextFont(3X)

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

SYNOPSIS
     #include <Xm/Xm.h>

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


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmFontListGetNextFont  accesses the character set and font for the next en-
     try of the font list. The application first uses the XmFontListInitFontCon-
     text routine to create a font list context.  The application then calls Xm-
     FontListGetNextFont repeatedly with the same context.  Each succeeding call
     accesses the next element of the font list.  When finished, 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 re-
     leases.  It is replaced by XmFontListNextEntry.   If  XmFontListGetNextFont
     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.


     contextSpecifies the font list context

     charsetSpecifies 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.

RELATED INFORMATION
     XmFontList(3X) and XmFontListNextEntry(3X).

                                                       XmFontListGetNextFont(3X)