1FvwmWinList(1)                   Fvwm Modules                   FvwmWinList(1)
2
3
4

NAME

6       FvwmWinList - the fvwm window list module
7

SYNOPSIS

9       FvwmWinList [name]
10
11       FvwmWinList  is  spawned  by  fvwm,  so no command line invocation will
12       work.
13
14

DESCRIPTION

16       The FvwmWinList module provides a window list made up of buttons,  each
17       corresponding  to a window that fvwm is managing.  Clicking on the but‐
18       tons with any of the three mouse  buttons  will  either  do  a  default
19       action  or can be user configured.  Like the other modules, FvwmWinList
20       only works when fvwm is used as the window manager.
21
22

COPYRIGHTS

24       The FvwmWinList module is the original work of Mike Finger.
25
26       Copyright 1994, Mike Finger. The author makes  no  guarantees  or  war‐
27       ranties  of any kind about the use of this module.  Use this modules at
28       your own risk.  You may freely use this module or any portion of it for
29       any purpose as long as the copyright is kept intact.
30
31

INITIALIZATION

33       During  initialization, FvwmWinList gets config info from fvwm's module
34       configuration database (see fvwm(1), section MODULE COMMANDS).   Avail‐
35       able options are discussed in a later section.
36
37

INVOCATION

39       FvwmWinList  can  be invoked by fvwm during initialization by inserting
40       the line 'Module FvwmWinList' in the .fvwm2rc file.
41
42       FvwmWinList can also be bound to a keystroke,  mouse  button,  or  menu
43       option  to be invoked later, in this case using 'Transient' as an argu‐
44       ment will cause FvwmWinList to resemble the built in window list.
45
46

CONFIGURATION OPTIONS

48       *FvwmWinList: Geometry {+-}<X>{+-}<Y>
49              Specifies the location and gravity of  the  FvwmWinList  window.
50              At  the current time, size is not supported and FvwmWinList will
51              resize itself as buttons are added.  If the NoAnchor  option  is
52              not  specified then the windows gravity corner will be anchored,
53              and the window will grow in the opposite  direction.   (i.e.  If
54              the  geometry  is specified -5-5, that is SoutEastGravity.  This
55              will cause the window to draw up and to the left as windows  are
56              added)
57
58
59       *FvwmWinList: Font font
60              Specifies the font to be used for labeling the buttons.
61
62
63       *FvwmWinList: Colorset n
64              Specifies  the  colorset  to use for the buttons. See FvwmTheme.
65              Defaults to 0.
66
67
68       *FvwmWinList: Fore color
69              Specifies the  color  to  use  for  the  button  names.  Cancels
70              *FvwmWinList: Colorset.
71
72
73       *FvwmWinList: Back color
74              Specifies  the color for the buttons. Cancels *FvwmWinList: Col‐
75              orset.
76
77
78       *FvwmWinList: FocusColorset n
79              Specifies the colorset to use for the button for the window that
80              has the input focus. Defaults to 1.
81
82
83       *FvwmWinList: FocusFore color
84              Specifies  the  color to use for the button names for the window
85              that has the input focus. If omitted, the color  from  *FvwmWin‐
86              List: Fore is used. Cancels *FvwmWinList: FocusColorset.
87
88
89       *FvwmWinList: FocusBack color
90              Specifies  the  color  to use for the button for the window that
91              has the input focus. If omitted, the  color  from  *FvwmWinList:
92              Back is used. Cancels *FvwmWinList: FocusColorset.
93
94
95       *FvwmWinList: IconColorset n
96              Specifies  the  colorset to use for buttons for windows that are
97              iconified. Defaults to 0.
98
99
100       *FvwmWinList: IconFore color
101              Specifies the color to use for the button names for windows that
102              are  iconified. If omitted, the color from *FvwmWinList: Fore is
103              used. Cancels *FvwmWinList: IconColorset.
104
105
106       *FvwmWinList: IconBack color
107              Specifies the color to use for the button for windows  that  are
108              iconified.  If  omitted,  the  color  from *FvwmWinList: Back is
109              used. Cancels *FvwmWinList: IconColorset.
110
111
112       *FvwmWinList: DontDepressFocus
113              By default FvwmWinList will show the button for the window  that
114              has  the  input  focus  as pressed in. This option disables that
115              feature.
116
117
118       *FvwmWinList: ButtonFrameWidth width
119              Specify the width of  the  3D  borders  around  the  buttons  in
120              FvwmWinList.
121
122
123       *FvwmWinList: FollowWindowList
124              Specifies  that FvwmWinList will keep its list in the same order
125              as fvwm.   This  is  the  order  displayed  by  the  "WindowList
126              NoDeskSort" fvwm command.  This is not the default as it is more
127              visually disturbing when the focus changes.
128
129
130       *FvwmWinList: UseSkipList
131              Tells FvwmWinList to not show the windows that are listed  on  a
132              WindowListSkip line in the configuration file.
133
134
135       *FvwmWinList: ShowCurrentDesk
136              Specifies that only windows on the current desk are displayed.
137
138
139       *FvwmWinList: NoAnchor
140              By  default,  FvwmWinList  will anchor the gravity corner so the
141              window will grow in the opposite direction.   This  undoes  that
142              option,  i.e. the window will always grow down.  Do not use this
143              option if a negative geometry was specified.
144
145
146       *FvwmWinList: UseIconNames
147              Tells FvwmWinList to use the icon name of the window instead  of
148              the  full  window name.  This is useful to keep the width of the
149              window small.
150
151
152       *FvwmWinList: LeftJustify
153              By default, FvwmWinList will center the icon text in  the  icon.
154              This  option  causes it to be justified flush with the left edge
155              of the icon. This option is turned on when MiniIcons are used.
156
157
158       *FvwmWinList: MinWidth width
159
160       *FvwmWinList: MaxWidth width
161              Specify the minimum and maximum widths  that  the  buttons  will
162              shrink  or  grow  to.  The buttons will normally size to fit the
163              longest name, but certain applications produce icon titles  that
164              can easily fill the screen.  Setting these parameters constrains
165              the size of the buttons to be between the two  values.   Setting
166              them  identically will fix the size of the buttons.  Setting Max
167              < Min will have unpredictable results.
168
169
170       *FvwmWinList: TruncateLeft
171              If names get truncated because of the  setting  of  FvwmWinList:
172              MaxWidth, they will normally get truncated on the right, so only
173              the start of the names are visible. Setting this  resource  will
174              cause  them  to  get  truncated  on the left, so that the end of
175              names are visible. This is useful when the window title contains
176              a directory and file name, for example.
177
178
179       *FvwmWinList: Action action response
180              Tells  FvwmWinList to do response when action is done.  The cur‐
181              rently supported actions are: Click1, Click2, Click3 and so  on.
182              By  default  the  module supports 3 mouse buttons, but it can be
183              compiled to support more.  The currently supported responses are
184              any  fvwm  built-in  commands,  including modules and functions.
185              Warning: The use of the former syntax that allowed to use  comma
186              separated  lists of commands is strongly discouraged due to syn‐
187              chronization problems with fvwm.  Please use complex fvwm  func‐
188              tions instead (defined with the 'AddToFunc' command of fvwm).
189
190
191       *FvwmWinList: NoIconAction action
192              Tells  FvwmWinList to do action is when a NoIcon style window is
193              iconified or de-iconified. Relevant coordinates are appended  to
194              action  so that the icon can be traced to an FvwmWinList button.
195              An example action is  "*FvwmWinList:  NoIconAction  SendToModule
196              FvwmAnimate  animate". A blank or null action turns this feature
197              off.
198
199

SAMPLE CONFIGURATION

201       The following are excepts from a .fvwm2rc file which describe  FvwmWin‐
202       List initialization commands:
203
204
205       ########
206       # Pop up the window list in transient mode on button 3 press & hold
207
208       Mouse 3   R   A   Module FvwmWinList Transient
209
210       AddToFunc DeiconifyAndRaise
211       + I Iconify off
212       + I Raise
213
214       ########################## Window-Lister ###############################
215       *FvwmWinList: Back DarkOliveGreen
216       *FvwmWinList: Fore PaleGoldenRod
217       *FvwmWinList: Font -*-new century schoolbook-bold-r-*-*-*-120-*-*-*-*-*-*
218       *FvwmWinList: Action Click1 Function DeiconifyAndRaise
219       *FvwmWinList: Action Click2 Iconify
220       *FvwmWinList: Action Click3 Module FvwmIdent
221       *FvwmWinList: UseSkipList
222       *FvwmWinList: UseIconNames
223       *FvwmWinList: Geometry -50-85
224       *FvwmWinList: MinWidth 70
225       *FvwmWinList: MaxWidth 120
226       # I prefer the text centered
227       #*FvwmWinList: LeftJustify
228       # I like it anchored
229       #*FvwmWinList: NoAnchor
230       # A flat list in most recently focused order
231       #*FvwmWinList: FollowWindowList
232       #*FvwmWinList: BorderReliefWidth 0
233       # pretend to be a taskbar
234       *FvwmWinList: NoIconAction SendToModule FvwmAnimate animate
235
236
237
238

AUTHOR

240       Mike Finger (mfinger@mermaid.micro.umn.edu)
241                   (Mike_Finger@atk.com)
242                   (doodman on IRC, check the #linux channel)
243
244       Various Patches by
245          John Heidemann <johnh@ficus.CS.UCLA.EDU> and
246          Jason L Tibbitts <tibbs@tcamc.uh.edu>.
247
248
249
2503rd Berkeley Distribution    09 May 2010 (2.5.30)               FvwmWinList(1)
Impressum