DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmFontListNextEntry(Xm)


XmFontListNextEntry -- a font list function that returns the next entry in a font list

Syntax

#include <Xm/Xm.h>

XmFontListEntry XmFontListNextEntry (context) 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 value

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.

See also

XmFontList(Xm), XmFontListEntryFree(Xm), XmFontListEntryGetFont(Xm), XmFontListEntryGetTag(Xm), XmFontListFreeFontContext(Xm) and XmFontListInitFontContext(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003