XmFontListNextEntry(library call) XmFontListNextEntry(library call)
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 appli-
cation 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 XmFontListNex-
tEntry 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 XmFontLis-
tInitFontContext(3).
XmFontListNextEntry(library call)
openMotif 2.3.1 - Generated Sun Nov 30 15:42:45 CST 2008