1XmFontListGetNextFont(library call)        XmFontListGetNextFont(library call)
2
3
4

NAME

6       XmFontListGetNextFont  —  A font list function that allows applications
7       to access the fonts and character sets in a font list
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       Boolean XmFontListGetNextFont(
12       XmFontContext context,
13       XmStringCharSet *charset,
14       XFontStruct **font);
15

DESCRIPTION

17       XmFontListGetNextFont accesses the character set and font for the  next
18       entry  of the font list. The application first uses the XmFontListInit‐
19       FontContext routine to create a font  list  context.   The  application
20       then calls XmFontListGetNextFont repeatedly with the same context. Each
21       succeeding call accesses the next element of the font list.  When  fin‐
22       ished,  the  application  calls  XmFontListFreeFontContext  to free the
23       allocated font list context.
24
25       This routine allocates memory for the character set string that must be
26       freed  by  the application.  The function allocates memory for charset.
27       The application is responsible for managing the allocated memory.   The
28       application can recover the allocated memory by calling XtFree.
29
30       This  function  is  obsolete and exists for compatibility with previous
31       releases. It is replaced by XmFontListNextEntry.  If XmFontListGetNext‐
32       Font is passed a context that contains a font set entry, it will return
33       the first font of the font set. The next call to the function will move
34       to the next entry in the font list.
35
36       context   Specifies the font list context
37
38       charset   Specifies  a  pointer  to a character set string; the routine
39                 returns the character set for the current font list element
40
41       font      Specifies a pointer to a pointer to  a  font  structure;  the
42                 routine returns the font for the current font list element
43

RETURN

45       Returns  True  if  the  returned  values  are valid; otherwise, returns
46       False.
47
49       XmFontList(3) and XmFontListNextEntry(3).
50
51
52
53                                           XmFontListGetNextFont(library call)
Impressum