XmFontList(3X) UNIX System V XmFontList(3X)
NAME
XmFontList - Data type for a font list
SYNOPSIS
#include <Xm/Xm.h>
VERSION
This page documents version 1.2 of the Motif library.
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 XmFONTLISTDEFAULTTAG. The value of
XmFONTLISTDEFAULTTAG 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 first font list entry whose tag matches the tag of
the compound string segment is used.
⊕ If no match has been found and if the tag of the
compound string segment is XmFONTLISTDEFAULTTAG, the
first font list entry whose tag matches the tag that
would result from creating an entry with
XmSTRINGDEFAULTCHARSET. For example, if creating an
entry with XmSTRINGDEFAULTCHARSET would result in the
tag "ISO8859-1", the compound string segment tag
XmFONTLISTDEFAULTTAG matches the font list entry tag
"ISO8859-1".
⊕ If no match has been found and if the tag of the
compound string segment matches the tag that would
result from creating a segment with
XmSTRINGDEFAULTCHARSET, the first font list entry
whose tag is XmFONTLISTDEFAULTTAG is used.
⊕ If no match has been found, the first entry in the font
list is used.
The font list interface consists of the routines listed
under "Related Information."
Font lists are specified in resource files using the
Page 1 (printed 4/30/98)
XmFontList(3X) UNIX System V XmFontList(3X)
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
RELATED INFORMATION
XmFontListAdd(3X), XmFontListAppendEntry(3X),
XmFontListCopy(3X), XmFontListCreate(3X),
XmFontListEntryCreate(3X), XmFontListEntryFree(3X),
XmFontListEntryGetFont(3X), XmFontListEntryGetTag(3X),
XmFontListEntryLoad(3X), XmFontListFree(3X),
XmFontListFreeFontContext(3X), XmFontListGetNextFont(3X),
XmFontListInitFontContext(3X), XmFontListNextEntry(3X),
XmFontListRemoveEntry(3X), and XmString(3X).
Page 2 (printed 4/30/98)