XmFontListNextEntry — A font list function that returns the next
entry in a font list "XmFontListNextEntry" "font list
functions" "XmFontListNextEntry"
#include <Xm/Xm.h>
XmFontListEntry XmFontListNextEntry(
XmFontContext context);
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
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.
XmFontList(3),
XmFontListEntryFree(3),
XmFontListEntryGetFont(3),
XmFontListEntryGetTag(3),
XmFontListFreeFontContext(3), and
XmFontListInitFontContext(3).