plucky (3) XmFontListNextEntry.3.gz

NAME

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

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(3)