Man Linux: Main Page and Category List

NAME

       XmFontListNextEntry  — A font list function that returns the next entry
       in a font list

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontListEntry XmFontListNextEntry(
       XmFontContext context);

DESCRIPTION

       XmFontListNextEntry returns the  next  entry  in  the  font  list.  The
       application 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
       XmFontListNextEntry 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

       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.
       If  the  function does return a font list entry, the font list entry is
       not a copy. Therefore, the application should  not  free  the  returned
       font list entry.

RELATED

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

                                             XmFontListNextEntry(library call)