Index of Section 1 Manual Pages
| Interix / SUA | FvwmWinList.1 | Interix / SUA |
FvwmWinList(1) FvwmWinList(1)
NAME
FvwmWinList - the FVWM window list module
SYNOPSIS
FvwmWinList [name]
FvwmWinList is spawned by fvwm, so no command line invoca-
tion will work.
DESCRIPTION
The FvwmWinList module provides a window 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.
COPYRIGHTS
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.
INITIALIZATION
During initialization, FvwmWinList gets config info from
fvwm's module configuration database (see fvwm2(1), sec-
tion MODULE COMMANDS). Available options are discussed in
a later section.
INVOCATION
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.
CONFIGURATION OPTIONS
*FvwmWinList: Geometry {+-}{+-}
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)
*FvwmWinList: Font font
Specifies the font to be used for labeling the but-
tons.
*FvwmWinList: Colorset n
Specifies the colorset to use for the buttons. See
FvwmTheme. Defaults to 0.
*FvwmWinList: Fore color
Specifies the color to use for the button names.
Cancels *FvwmWinList: Colorset.
*FvwmWinList: Back color
Specifies the color for the buttons. Cancels
*FvwmWinList: Colorset.
*FvwmWinList: FocusColorset n
Specifies the colorset to use for the button for
the window that has the input focus. Defaults to 1.
*FvwmWinList: FocusFore color
Specifies the color to use for the button names for
the window that has the input focus. If omitted,
the color from FvwmWinListFore is used. Cancels
*FvwmWinList: FocusColorset.
*FvwmWinList: FocusBack color
Specifies the color to use for the button for the
window that has the input focus. If omitted, the
color from FvwmWinListBack is used. Cancels
*FvwmWinList: FocusColorset.
*FvwmWinList: IconColorset n
Specifies the colorset to use for buttons for win-
dows that are iconified. Defaults to 0.
*FvwmWinList: IconFore color
Specifies the color to use for the button names for
windows that are iconified. If omitted, the color
from FvwmWinListFore is used. Cancels *FvwmWinList:
IconColorset.
*FvwmWinList: IconBack color
Specifies the color to use for the button for win-
dows that are iconified. If omitted, the color from
FvwmWinListBack is used. Cancels *FvwmWinList:
IconColorset.
*FvwmWinList: DontDepressFocus
By default FvwmWinList will show the button for the
window that has the input focus as pressed in. This
option disables that feature.
*FvwmWinList: ButtonFrameWidth width
Specify the width of the 3D borders around the but-
tons in FvwmWinList.
*FvwmWinList: FollowWindowList
Specifies that FvwmWinList will keep its list in
the same order as FVWM. This is the order dis-
played by the "WindowList NoDeskSort" FVWM command.
This is not the default as it is more visually dis-
turbing when the focus changes.
*FvwmWinList: UseSkipList
Tells FvwmWinList to not show the windows that are
listed on a WindowListSkip line in the configura-
tion file.
*FvwmWinList: ShowCurrentDesk
Specifies that only windows on the current desk are
displayed.
*FvwmWinList: NoAnchor
By default, FvwmWinList will anchor the gravity
corner so the window will grow in the opposite
direction. This undoes that option, i.e. the win-
dow will always grow down. Do not use this option
if a negative geometry was specified.
*FvwmWinList: UseIconNames
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.
*FvwmWinList: LeftJustify
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. This option
is turned on when MiniIcons are used.
*FvwmWinList: MinWidth width
*FvwmWinList: MaxWidth width
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.
*FvwmWinList: TruncateLeft
If names get truncated because of the setting of
FvwmWinListMaxWidth, 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.
*FvwmWinList: Action action response
Tells FvwmWinList to do response when action is
done. The currently supported actions are: Click1,
Click2, Click3 and so on. By default the module
supports 3 mouse buttons, but it can be compiled to
support more. The currently supported responses
are any fvwm built-in commands, including modules
and functions. Warning: The use of the former syn-
tax that allowed to use comma separated lists of
commands is strongly discouraged due to synchro-
nization problems with fvwm. Please use complex
fvwm functions instead (defined with the 'AddTo-
Func' command of fvwm).
*FvwmWinList: NoIconAction action
Tells FvwmWinList to do action is when a NoIcon
style window is iconified or de-iconified. Relevant
coordinates are appended to action so that the icon
can be traced to an FvwmWinList button. An example
action is "*FvwmWinList: NoIconAction SendToModule
FvwmAnimate animate". A blank or null action turns
this feature off.
SAMPLE CONFIGURATION
The following are excepts from a .fvwmrc file which
describe FvwmWinList initialization commands:
########
# Pop up the window list in transient mode on button 3 press & hold
Mouse 3 R A Module FvwmWinList Transient
AddToFunc DeiconifyAndRaise
+ I Iconify off
+ I Raise
########################## Window-Lister ###############################
*FvwmWinList: Back DarkOliveGreen
*FvwmWinList: Fore PaleGoldenRod
*FvwmWinList: Font -*-new century schoolbook-bold-r-*-*-*-120-*-*-*-*-*-*
*FvwmWinList: Action Click1 Function DeiconifyAndRaise
*FvwmWinList: Action Click2 Iconify
*FvwmWinList: Action Click3 Module FvwmIdent
*FvwmWinList: UseSkipList
*FvwmWinList: UseIconNames
*FvwmWinList: Geometry -50-85
*FvwmWinList: MinWidth 70
*FvwmWinList: MaxWidth 120
# I prefer the text centered
#*FvwmWinList: LeftJustify
# I like it anchored
#*FvwmWinList: NoAnchor
# A flat list in most recently focused order
#*FvwmWinList: FollowWindowList
#*FvwmWinList: BorderReliefWidth 0
# pretend to be a taskbar
*FvwmWinList: NoIconAction SendToModule FvwmAnimate animate
AUTHOR
Mike Finger (mfinger@mermaid.micro.umn.edu)
(Mike_Finger@atk.com)
(doodman on IRC, check the #linux channel)
Various Patches by
John Heidemann and
Jason L Tibbitts .
3 July 2001 FvwmWinList(1)