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

NAME

6       XmFontListNextEntry  — A font list function that returns the next entry
7       in a font list
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmFontListEntry XmFontListNextEntry(
12       XmFontContext context);
13

DESCRIPTION

15       XmFontListNextEntry returns the next entry in the font list. The appli‐
16       cation uses the XmFontListInitFontContext routine to create a font list
17       context. The first call to XmFontListNextEntry sets the context to  the
18       first entry in the font list. The application then calls XmFontListNex‐
19       tEntry repeatedly with the same context. Each succeeding call  accesses
20       the  next  entry of the font list. When finished, the application calls
21       XmFontListFreeFontContext to free the allocated font list context.
22
23       context   Specifies the font list context
24

RETURN

26       Returns NULL if the context does not refer to a valid entry or if it is
27       at  the  end of the font list; otherwise, it returns a font list entry.
28       If the function does return a font list entry, the font list  entry  is
29       not  a  copy.  Therefore,  the application should not free the returned
30       font list entry.
31
33       XmFontList(3),    XmFontListEntryFree(3),    XmFontListEntryGetFont(3),
34       XmFontListEntryGetTag(3),  XmFontListFreeFontContext(3), and XmFontLis‐
35       tInitFontContext(3).
36
37
38
39                                             XmFontListNextEntry(library call)
Impressum