XmFontListGetNextFont(3X) OSF XmFontListGetNextFont(3X)
NAME
XmFontListGetNextFont-A font list 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 font list. 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 font
list. 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.
This function is obsolete and exists for compatibility with
previous releases. It is replaced by XmFontListNextEntry.
If XmFontListGetNextFont is passed a context that contains a
font set entry, it will return the first font of the font
set. The next call to the function will move to the next
entry in the font list.
contextSpecifies the font list context
charsetSpecifies 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
1 (printed 6/8/92)
XmFontListGetNextFont(3X) OSF XmFontListGetNextFont(3X)
XmFontList(3X) and XmFontListNextEntry(3X).
2 (printed 6/8/92)