1XmFontList(library call)                              XmFontList(library call)
2
3
4

NAME

6       XmFontList — Data type for a font list
7

SYNOPSIS

9       #include <Xm/Xm.h>
10

DESCRIPTION

12       XmFontList  is  the  data type for a font list. A font list consists of
13       font list entries. Each entry contains a font or a font set (a group of
14       fonts)  and is identified with a tag, which is optional. If this tag is
15       NULL, the tag is set to XmFONTLIST_DEFAULT_TAG.
16
17       The value of XmFONTLIST_DEFAULT_TAG is XmFONTLIST_DEFAULT_TAG_STRING.
18
19       When a compound string is displayed, the font list element tag  of  the
20       compound  string  segment  is matched with a font list entry tag in the
21       font list and the matching font list entry is used to display the  com‐
22       pound string. A font list entry is chosen as follows:
23
24          ·  The  first  font list entry whose tag matches the tag of the com‐
25             pound string segment is used.
26
27          ·  If no match has been found and if the tag of the compound  string
28             segment  is  XmFONTLIST_DEFAULT_TAG,  the  first  font list entry
29             whose tag matches the tag that  would  result  from  creating  an
30             entry  with  XmSTRING_DEFAULT_CHARSET  is  used.  For example, if
31             creating an entry with XmSTRING_DEFAULT_CHARSET would  result  in
32             the    tag   ISO8859-1,   the   compound   string   segment   tag
33             XmFONTLIST_DEFAULT_TAG matches the font list entry tag ISO8859-1.
34
35          ·  If no match has been found and if the tag of the compound  string
36             segment matches the tag that would result from creating a segment
37             with XmSTRING_DEFAULT_CHARSET, the first font  list  entry  whose
38             tag is XmFONTLIST_DEFAULT_TAG is used.
39
40          ·  If  no  match has been found, the first entry in the font list is
41             used.
42
43       The font list interface consists of  the  routines  listed  in  Related
44       Information.
45
46       Font lists are specified in resource files with the following syntax:
47
48       resource_spec:  font_entry [, font_entry ]+
49
50       The  resource  value  string  consists of one or more font list entries
51       separated by commas. Each font_entry identifies a font or font set  and
52       an optional font list entry tag. A tag specified for a single font fol‐
53       lows the font name and is separated by = (equals sign); otherwise, in a
54       font set the tag is separated by a colon. The colon is required whether
55       a tag is specified or not. A font entry uses the  following  syntax  to
56       specify a single font:
57
58       font_name [ '=' tag ]
59
60       For example, the following entry specifies a 10 point Times Italic font
61       without a font list entry tag;
62
63       *fontList:  -Adobe-Times-Medium-I-Normal--10*
64
65       A font entry containing a font set is similar, except a semicolon sepa‐
66       rates  multiple font names and the specification ends with a colon fol‐
67       lowed by an optional tag:
68
69       font_name [ ';' font_name ]+ ':' [ tag ]
70
71       A font_name is an X Logical Font Description (XLFD) string and  tag  is
72       any  set of characters from ISO646IRV except space, comma, colon, equal
73       sign and semicolon. Following is an example of a  font  set  entry.  It
74       consists  of  three  fonts  (except for charsets), and an explicit font
75       list entry tag.
76
77       *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
78
79       Note that the XmRenderTable is another data type that can be  used  for
80       font lists. Refer to the XmRenderTable(3) for details.
81
83       XmFontListAdd(3),      XmFontListAppendEntry(3),     XmFontListCopy(3),
84       XmFontListCreate(3), XmFontListEntryCreate(3),  XmFontListEntryFree(3),
85       XmFontListEntryGetFont(3),  XmFontListEntryGetTag(3),  XmFontListEntry‐
86       Load(3), XmFontListFree(3),  XmFontListFreeFontContext(3),  XmFontList‐
87       GetNextFont(3),  XmFontListInitFontContext(3),  XmFontListNextEntry(3),
88       XmFontListRemoveEntry(3), XmRenderTable(3), and XmString(3).
89
90
91
92                                                      XmFontList(library call)
Impressum