OSF

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)
XmFontContext context;
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. 

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

fontSpecifies 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).