XmFontList(3X) SDK X11 R4.11MU05 XmFontList(3X)
NAME
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 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 following
syntax:
resourcespec: fontentry [ , fontentry ]+
The resource value string consists of one or more font list entries
separated by commas. Each fontentry 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:
fontname [ '=' 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.
fontname [ ';' fontname ]+ ':' [ tag ]
A fontname 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).
Licensed material--property of copyright holder(s)