XmFontListGetNextFont(3X) UNIX System V XmFontListGetNextFont(3X)
NAME
XmFontListGetNextFont - a compound string function that allows
applications to access the fonts and character sets in a font list.
SYNOPSIS
#include <Xm/Xm.h>
Boolean XmFontListGetNextFont (context, charset, font)
XmFontContextcontext;
XmStringCharSet* charset;
XFontStruct ** font;
DESCRIPTION
XmFontListGetNextFont accesses the character set and font for the next
entry of the fontlist. The application first uses the
XmFontListInitFontContext routine to create a font list context. The
application then calls XmFontListGetNextFont repeatedly with the same
context. Each succeeding call accesses the next element of the fontlist.
When finished, the application calls XmFontListFreeFontContext to free
the allocated font list context.
This routine allocates memory for the character set string that must be
freed by the application.
context
Specifies the font list context
charset
Specifies a pointer to a character set string; the routine returns
the character set for the current font list element
font Specifies a pointer to a pointer to a font structure; the routine
returns the font for the current font list element
RETURN VALUE
Returns True if the returned values are valid; otherwise, returns False.
RELATED INFORMATION
XmFontListFreeFontContext(3X) and XmFontListInitFontContext(3X).
10/89 Page 1