XmFontList(3X)															    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 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 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 XmFONTLIST_DEFAULT_TAG, the first font list entry whose tag matches the tag that would result from creating an entry with
       XmSTRING_DEFAULT_CHARSET. For example, if creating an entry with XmSTRING_DEFAULT_CHARSET would result in the tag "ISO8859-1", the compound
       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 segment matches the tag that would result from creating a segment with XmSTRING_DEFAULT_CHARSET, the first font list entry
       whose tag is XmFONTLIST_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 SEE ALSO.

       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-Nor-
       mal--10*

       A font entry containing a font set is similar except a semicolon separates multiple font names and the specification ends with a colon fol-
       lowed 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;.nL

SEE ALSO

       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), XmString(3X)

																    XmFontList(3X)