NAME    [Toc]    [Back]

       XmFontList - Data type for a font list

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

DESCRIPTION    [Toc]    [Back]

       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:   -AdobeTimes-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;.nL

SEE ALSO    [Toc]    [Back]

       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)