XmFontList(X3mot)


XmFontList -- data type for a font list

Synopsis

#include <Xm/Xm.h>

Description

XmFontList is the data type for a font list. A font list consists of font list entries, each of which contains a font or a font set (a group of fonts) and is identified with a tag. The font list entry tag is optional; if NULL, the tag is set to XmFONTLIST_DEFAULT_TAG. The value of XmFONTLIST_DEFAULT_TAG is XmFONTLIST_DEFAULT_TAG_STRING.

When a compound string is displayed, the font list element tag of the compound string segment is matched with a font list entry tag in the font list and the matching font list entry is used to display the compound string. A font list entry is chosen as follows:

The font list interface consists of the routines listed under the ``See also'' section.

Font lists are specified in resource files using the following syntax:

resource_spec: font_entry [ , font_entry ]+

The resource value string consists of one or more font list entries separated by commas. Each font_entry identifies a font or font set, and an optional font list entry tag. A tag specified for a single font follows the font name and is separated by ``=''; otherwise, in a font set the tag is separated by a colon. The colon is required whether a tag is specified or not. A font entry uses the following syntax to specify a single font:

font_name [ = tag ]

For example, this entry specifies a 10 point Times Italic font without a font list entry tag.

   *fontList:  -Adobe-Times-Medium-I-Normal--10*
A font entry containing a font set is similar except a semicolon separates multiple font names and the specification ends with a colon followed by an optional tag.

font_name [ ; font_name ]+ : [ tag ]

A font_name is an X Logical Font Description (XLFD) string and tag is any set of characters from ISO646IRV except space, comma, colon, equal sign and semicolon. An example of a font set entry is given below. It consists of three fonts (except for charsets), and an explicit font list entry tag.

   *fontList : -Adobe-Courier-Bold-R-Normal--25-180-100-100-M-150;\
   -JIS-Fixed-Medium-R-Normal--26-180-100-100-C-240;\
   -JIS-Fixed-Medium-R-Normal--26-180-100-100-C-120:MY_TAG

References

XmFontListAdd(X3mot), XmFontListAppendEntry(X3mot), XmFontListCopy(X3mot), XmFontListCreate(X3mot), XmFontListEntryCreate(X3mot), XmFontListEntryFree(X3mot), XmFontListEntryGetFont(X3mot), XmFontListEntryGetTag(X3mot), XmFontListEntryLoad(X3mot), XmFontListFree(X3mot), XmFontListFreeFontContext(X3mot), XmFontListGetNextFont(X3mot), XmFontListInitFontContext(X3mot), XmFontListNextEntry(X3mot), XmFontListRemoveEntry(X3mot) and XmString(X3mot).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004