1XmFontList(library call) XmFontList(library call)
2
3
4
6 XmFontList — Data type for a font list
7
9 #include <Xm/Xm.h>
10
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)