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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
<HTML>
<BODY>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
FvwmWinList - the FVWM window list module
</PRE>
<H2>SYNOPSIS</H2><PRE>
FvwmWinList is spawned by fvwm, so no command line invoca-
tion will work.
</PRE>
<H2>DESCRIPTION</H2><PRE>
The FvwmWinList module provides a widow list made up of
buttons, each corresponding to a window that FVWM is man-
aging. Clicking on the buttons with any of the three
mouse buttons will either do a default action or can be
user configured. Like the other modules, FvwmWinList only
works when fvwm is used as the window manager.
</PRE>
<H2>COPYRIGHTS</H2><PRE>
The FvwmWinList module is the original work of Mike Fin-
ger.
Copyright 1994, Mike Finger. The author makes no guaran-
tees or warranties of any kind about the use of this mod-
ule. Use this modules at your own risk. You may freely
use this module or any portion of it for any purpose as
long as the copyright is kept intact.
</PRE>
<H2>INITIALIZATION</H2><PRE>
During initialization, <I>FvwmWinList</I> will scan the same con-
figuration file that FVWM used during startup to find the
options that pertain to it. These options are discussed
in a later section.
</PRE>
<H2>INVOCATION</H2><PRE>
FvwmWinList can be invoked by fvwm during initialization
by inserting the line 'Module FvwmWinList' in the .fvwmrc
file.
FvwmWinList can also be bound to a keystroke, mouse but-
ton, or menu option to be invoked later, in this case
using 'Transient' as an argument will cause FvwmWinList to
resemble the built in window list.
FvwmWinList must reside in a directory that is listed in
the ModulePath option of FVWM for it to be executed by
FVWM.
</PRE>
<H2>CONFIGURATION OPTIONS</H2><PRE>
The following options can be placed in the .fvwmrc file
Specifies the location and gravity of the FvwmWin-
List window. At the current time, size is not sup-
ported and FvwmWinList will resize itself as but-
tons are added. If the NoAnchor option is not
specified then the windows gravity corner will be
anchored, and the window will grow in the opposite
direction. (i.e. If the geometry is specified
-5-5, that is SoutEastGravity. This will cause the
window to draw up and to the left as windows are
added)
*FvwmWinListFont <I>font</I>
Specifies the font to be used for labeling the but-
tons.
*FvwmWinListFore <I>color</I>
Specifies the color to use for the button names.
*FvwmWinListBack <I>color</I>
Specifies the color for the buttons.
*FvwmWinListFocusFore <I>color</I>
Specifies the color to use for the button names for
the window that has the input focus. If omitted,
the color from <B>FvwmWinListFore</B> is used.
*FvwmWinListFocusBack <I>color</I>
Specifies the color to use for the button for the
window that has the input focus. If omitted, the
color from <B>FvwmWinListBack</B> is used.
*FvwmWinListIconFore <I>color</I>
Specifies the color to use for the button names for
windows that are iconified. If omitted, the color
from <B>FvwmWinListFore</B> is used.
*FvwmWinListFocusBack <I>color</I>
Specifies the color to use for the button for win-
dows that are iconified. If omitted, the color from
<B>FvwmWinListBack</B> is used.
*FvwmWinListUseSkipList
Tells FvwmWinList to not show the windows that are
listed on a WindowListSkip line if the configura-
By default, FvwmWinList will anchor the gravity
corner so the window will grow in the opposite
direction. This undoes that option.
*FvwmWinListUseIconNames
Tells FvwmWinList to use the icon name of the win-
dow instead of the full window name. This is use-
ful to keep the width of the window small.
*FvwmWinListLeftJustify
By default, FvwmWinList will center the icon text
in the icon. This option causes it to be justified
flush with the left edge of the icon.
*FvwmWinListMinWidth <I>width</I>
*FvwmWinListMaxWidth <I>width</I>
Specify the minimum and maximum widths that the
buttons will shrink or grow to. The buttons will
normally size to fit the longest name, but certain
applications produce icon titles that can easily
fill the screen. Setting these parameters con-
strains the size of the buttons to be between the
two values. Setting them identically will fix the
size of the buttons. Setting Max < Min will have
unpredictable results.
*FvwmWinListTruncateLeft
If names get truncated because of the setting of
<B>FvwmWinListMaxWidth</B>, they will normally get trun-
cated on the right, so only the start of the names
are visible. Setting this resource will cause them
to get truncated on the left, so that the end of
names are visible. This is useful when the window
title contains a directory and file name, for exam-
ple.
*FvwmWinListTruncateRight
This is the inverse of <B>FvwmWinListTruncateLeft</B>; it
is the default action. It is provided for complete-
ness.
*FvwmWinListAction <I>action</I> <I>response[,reponse...]</I>
Tells FvwmWinList to do <I>response</I> when <I>action</I> is
done. The currently supported <I>action</I>s are: Click1,
Click2, Click3. The currently supported <I>response</I>s
</PRE>
<H2>SAMPLE CONFIGURATION</H2><PRE>
The following are excepts from a .fvwmrc file which
describe FvwmWinList initialization commands:
########
# Pop up the window list in tranient mode on button 3 press & hold
Mouse 3 R A Module "FvwmWinList" FvwmWinList Transient
########################## Window-Lister ###############################
*FvwmWinListBack DarkOliveGreen
*FvwmWinListFore PaleGoldenRod
*FvwmWinListFont -*-new century schoolbook-bold-r-*-*-*-120-*-*-*-*-*-*
*FvwmWinListAction Click1 Iconify -1,Raise
*FvwmWinListAction Click2 Iconify
*FvwmWinListAction Click3 Module "FvwmIdent" FvwmIdent
*FvwmWinListUseSkipList
*FvwmWinListUseIconNames
*FvwmWinListGeometry -50-85
*FvwmWinListMinWidth 70
*FvwmWinListMaxWidth 120
# I prefer the text centered
#*FvwmWinListLeftJustify
# I like it achored
#*FvwmWinListNoAnchor
</PRE>
<H2>AUTHOR</H2><PRE>
Mike Finger (mfinger@mermaid.micro.umn.edu)
(Mike_Finger@atk.com)
(doodman on IRC, check the #linux channel)
Various Patches by
John Heidemann <johnh@ficus.CS.UCLA.EDU> and
Jason L Tibbitts <tibbs@tcamc.uh.edu>.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|
