manpagez: man pages & more
man XmFontList(3)
Home | html | info | man
XmFontList(library call)                              XmFontList(library call)




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 entry contains a font or a font set (a group of
       fonts)  and is identified with a tag, which is optional. If this tag is
       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  com-
       pound string. A font list entry is chosen as follows:

          o  The  first  font list entry whose tag matches the tag of the com-
             pound string segment is used.

          o  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  is  used.  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.

          o  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.

          o  If no match has been found, the first entry in the font  list  is
             used.

       The  font  list  interface  consists  of the routines listed in Related
       Information.

       Font lists are specified in resource files with 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 fol-
       lows the font name and is separated by = (equals sign); 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, the following 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 sepa-
       rates 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.  Following  is an example of a font set entry. 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


       Note  that  the XmRenderTable is another data type that can be used for
       font lists. Refer to the XmRenderTable(3) for details.


RELATED

       XmFontListAdd(3),     XmFontListAppendEntry(3),      XmFontListCopy(3),
       XmFontListCreate(3),  XmFontListEntryCreate(3), XmFontListEntryFree(3),
       XmFontListEntryGetFont(3),  XmFontListEntryGetTag(3),  XmFontListEntry-
       Load(3),  XmFontListFree(3),  XmFontListFreeFontContext(3), XmFontList-
       GetNextFont(3),  XmFontListInitFontContext(3),  XmFontListNextEntry(3),
       XmFontListRemoveEntry(3), XmRenderTable(3), and XmString(3).



                                                      XmFontList(library call)

openMotif 2.3.1 - Generated Sun Nov 30 14:02:46 CST 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.