XmFontList(3X)
XmFontList --Data type for a font list
As shipped in IRIX 6.5.5. Unchanged since IRIX 6.5.
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 XmFONTLIST_DEFAULT_TAG. The value of Xm- FONTLIST_DEFAULT_TAG is "XmFONTLIST_DEFAULT_TAG_STRING". When a compound string is displayed, the font list element tag of the com- pound 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 seg- ment is XmFONTLIST_DEFAULT_TAG, the first font list entry whose tag matches the tag that would result from creating an entry with Xm- STRING_DEFAULT_CHARSET. For example, if creating an entry with Xm- STRING_DEFAULT_CHARSET would result in the tag "ISO8859-1", the com- pound string segment tag XmFONTLIST_DEFAULT_TAG matches the font list entry tag "ISO8859-1". * If no match has been found and if the tag of the compound string seg- ment matches the tag that would result from creating a segment with XmSTRING_DEFAULT_CHARSET, the first font list entry whose tag is Xm- FONTLIST_DEFAULT_TAG 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 In- formation." 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 sepa- rated by commas. Each font_entry identifies a font or font set, and an op- tional 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 sepa- rated 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), Xm- FontListCreate(3X), XmFontListEntryCreate(3X), XmFontListEntryFree(3X), Xm- FontListEntryGetFont(3X), XmFontListEntryGetTag(3X), XmFontListEntry- Load(3X), XmFontListFree(3X), XmFontListFreeFontContext(3X), XmFontListGet- NextFont(3X), XmFontListInitFontContext(3X), XmFontListNextEntry(3X), Xm- FontListRemoveEntry(3X), and XmString(3X). XmFontList(3X)