NAME

       XmFontListGetNextFont  —  A font list function that allows applications to access the fonts and character
       sets in a font list "XmFontListGetNextFont" "font list functions" "XmFontListGetNextFont"

SYNOPSIS

       #include <Xm/Xm.h>
       Boolean XmFontListGetNextFont(
       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  XmFontListInitFontContext  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   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.   The
       function allocates memory for charset.  The application is responsible for managing the allocated memory.
       The application can recover the allocated memory by calling XtFree.

       This  function  is  obsolete  and  exists  for  compatibility  with  previous releases. 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.

       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

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

RELATED

       XmFontList(3) and XmFontListNextEntry(3).

                                                                                        XmFontListGetNextFont(3)