XmFontListGetNextFont(library call) XmFontListGetNextFont(library call)

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(
XmFontContext context,
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. The function allocates memory for
charset. The application is responsible for managing the allocated
memory. The application can recover the allocated memory by calling
XtFree.

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.

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

Returns True if the returned values are valid; otherwise, returns
False.

RELATED

XmFontList(3) and XmFontListNextEntry(3).

XmFontListGetNextFont(library call)