1FvwmWinList(1) Fvwm Modules FvwmWinList(1)
2
6 FvwmWinList - the fvwm window list module
7
9 FvwmWinList [name]
10 FvwmWinList is spawned by fvwm, so no command line invocation will
12 work.
13
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
24 The FvwmWinList module is the original work of Mike Finger.
25 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
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
39 FvwmWinList can be invoked by fvwm during initialization by inserting
40 the line 'Module FvwmWinList' in the .fvwm2rc file.
41 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
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 *FvwmWinList: Font font
60 Specifies the font to be used for labeling the buttons.
61 *FvwmWinList: Colorset n
64 Specifies the colorset to use for the buttons. See FvwmTheme.
65 Defaults to 0.
66 *FvwmWinList: Fore color
69 Specifies the color to use for the button names. Cancels
70 *FvwmWinList: Colorset.
71 *FvwmWinList: Back color
74 Specifies the color for the buttons. Cancels *FvwmWinList: Col‐
75 orset.
76 *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 *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 *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 *FvwmWinList: IconColorset n
96 Specifies the colorset to use for buttons for windows that are
97 iconified. Defaults to 0.
98 *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 *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 *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 *FvwmWinList: ButtonFrameWidth width
119 Specify the width of the 3D borders around the buttons in
120 FvwmWinList.
121 *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 *FvwmWinList: UseSkipList
131 Tells FvwmWinList to not show the windows that are listed on a
132 WindowListSkip line in the configuration file.
133 *FvwmWinList: ShowCurrentDesk
136 Specifies that only windows on the current desk are displayed.
137 *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 *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 *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 *FvwmWinList: MinWidth width
159 *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 *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 *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 *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
201 The following are excepts from a .fvwm2rc file which describe FvwmWin‐
202 List initialization commands:
203 ########
206 # Pop up the window list in transient mode on button 3 press & hold
207 Mouse 3 R A Module FvwmWinList Transient
209 AddToFunc DeiconifyAndRaise
211 + I Iconify off
212 + I Raise
213 ########################## 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
240 Mike Finger (mfinger@mermaid.micro.umn.edu)
241 (Mike_Finger@atk.com)
242 (doodman on IRC, check the #linux channel)
243 Various Patches by
245 John Heidemann <johnh@ficus.CS.UCLA.EDU> and
246 Jason L Tibbitts <tibbs@tcamc.uh.edu>.
2473rd Berkeley Distribution 24 November 2007 (2.5.24) FvwmWinList(1)