1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
'\" t
...\" FontList.sgm /main/8 1996/09/08 20:43:12 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl \" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl \" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie !\\*(f4 \{\
. ft \\*(f4
. ds f4\"
' br \}
.el .ie !\\*(f3 \{\
. ft \\*(f3
. ds f3\"
' br \}
.el .ie !\\*(f2 \{\
. ft \\*(f2
. ds f2\"
' br \}
.el .ie !\\*(f1 \{\
. ft \\*(f1
. ds f1\"
' br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
.TH "XmFontList" "library call"
.SH "NAME"
\fBXmFontList\fR \(em Data type for a font list
.iX "XmFontList"
.iX "data types" "XmFontList"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Xm\&.h>
.fi
.SH "DESCRIPTION"
.PP
\fBXmFontList\fR 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 \fBXmFONTLIST_DEFAULT_TAG\fP\&.
.PP
The value of
\fBXmFONTLIST_DEFAULT_TAG\fP is \fBXmFONTLIST_DEFAULT_TAG_STRING\fP\&.
.PP
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:
.IP " \(bu" 6
The first font list entry whose tag matches the tag of the compound
string segment is used\&.
.IP " \(bu" 6
If no match has been found and if the tag of the compound string
segment is \fBXmFONTLIST_DEFAULT_TAG\fP, the first font list
entry whose tag matches the tag that would result from creating
an entry with \fBXmSTRING_DEFAULT_CHARSET\fP is used\&.
For example, if creating an entry with \fBXmSTRING_DEFAULT_CHARSET\fP
would result in the tag \fBISO8859-1\fP, the compound string segment
tag \fBXmFONTLIST_DEFAULT_TAG\fP matches the font list entry tag
\fBISO8859-1\fP\&.
.IP " \(bu" 6
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 \fBXmSTRING_DEFAULT_CHARSET\fP, the first font list entry
whose tag is \fBXmFONTLIST_DEFAULT_TAG\fP is used\&.
.IP " \(bu" 6
If no match has been found, the first entry in the font list is
used\&.
.PP
The font list interface consists of the routines listed
in \fBRelated Information\fP\&.
.PP
Font lists are specified in resource files with the following syntax:
.PP
.nf
\fIresource_spec\fP\fB:\fP \fIfont_entry\fP [, \fIfont_entry\fP ]+
.fi
.PP
The resource value string consists of one or more font list entries
separated by commas\&. Each \fIfont_entry\fP 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 = (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:
.PP
.nf
\fIfont_name\fP [ \&'=\&' \fItag\fP ]
.fi
.PP
For example, the following entry specifies a 10 point Times Italic font
without a font list entry tag;
.PP
.nf
\f(CW*fontList: \-Adobe\-Times\-Medium\-I\-Normal\-\-10*\fR
.fi
.PP
.PP
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:
.PP
.nf
\fIfont_name\fP [ \&';\&' \fIfont_name\fP ]+ \&':\&' [ \fItag\fP ]
.fi
.PP
A \fIfont_name\fP is an X Logical Font Description (XLFD) string
and \fItag\fP 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\&.
.PP
.nf
\f(CW*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\fR
.fi
.PP
.PP
Note that the \fBXmRenderTable\fR is another data type that can be
used for font lists\&. Refer to the \fBXmRenderTable\fP(3) for details\&.
.SH "RELATED"
.PP
\fBXmFontListAdd\fP(3),
\fBXmFontListAppendEntry\fP(3),
\fBXmFontListCopy\fP(3),
\fBXmFontListCreate\fP(3),
\fBXmFontListEntryCreate\fP(3),
\fBXmFontListEntryFree\fP(3),
\fBXmFontListEntryGetFont\fP(3),
\fBXmFontListEntryGetTag\fP(3),
\fBXmFontListEntryLoad\fP(3),
\fBXmFontListFree\fP(3),
\fBXmFontListFreeFontContext\fP(3),
\fBXmFontListGetNextFont\fP(3),
\fBXmFontListInitFontContext\fP(3),
\fBXmFontListNextEntry\fP(3),
\fBXmFontListRemoveEntry\fP(3),
\fBXmRenderTable\fP(3),
and
\fBXmString\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:23
|
