XmFontListNextEntry(library call) XmFontListNextEntry(library call)
NAME [Toc] [Back]
XmFontListNextEntry - A font list function that returns the next entry
in a font list
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmFontListEntry XmFontListNextEntry(
XmFontContext context);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
XmFontList(3), XmFontListEntryFree(3), XmFontListEntryGetFont(3),
XmFontListEntryGetTag(3), XmFontListFreeFontContext(3), and
XmFontListInitFontContext(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
