Volume 6A: Motif Programming Manual

XmFontListEntry

XmFontListNextEntry(context)

XmFontContext context;

This routine cycles through all of the font list entries in the font list. The first call returns the first entry in the font list;

repeated calls using the same font context access successive entries. Since the XmFontListEntry type is also

opaque, you have to use XmFontListEntryGetFont() and XmFontListEntryGetTag() to retrieve the

actual font or font set and tag for the font list entry. These routines take the following form:

XtPointer

XmFontListEntryGetFont(entry, type_return)

XmFontListEntry entry;

XmFontType *type_return;

char *

XmFontListEntryGetTag(entry)

XmFontListEntry entry;

XmFontListEntryGetFont() returns an XFontStruct or an XFontSet depending on the value of

type_return. The routine does not copy the data structure, so the application must not free it.

XmFontListEntryGetTag() retrieves the tag for the font list entry. This routine allocates storage for the tag, so

the application must free it.

In Motif 1.1, you call XmFontListGetNextFont() to cycle through the fonts in a font list. This routine has the

following form:

Boolean

XmFontListGetNextFont(context, charset, font)

XmFontContext context;

XmStringCharSet *charset;

XFontStruct **font;

If the function returns True, the character set and font pointers are set to the appropriate values. The charset

returned is a pointer to allocated data that must be freed when no longer needed. The value for font points to the

actual XFontStruct data used in the font list, ...