FvwmWinList1 - Online in the Cloud

PROGRAM:

NAME

FvwmWinList - the FVWM window list module

SYNOPSIS

FvwmWinList is spawned by fvwm, so no command line invocation will work.

DESCRIPTION

The FvwmWinList module provides a widow list made up of buttons, each corresponding to a
window that FVWM is managing. 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 Finger.

Copyright 1994, Mike Finger. The author makes no guarantees or warranties of any kind
about the use of this module. 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 will scan the same configuration file that FVWM used
during startup to find the options that pertain to it. These 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 button, 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

The following options can be placed in the .fvwmrc file

*FvwmWinListGeometry {+-}<X>x{+-}<Y>
Specifies the location and gravity of the FvwmWinList window. At the current time,
size is not supported and FvwmWinList will resize itself as buttons 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 font
Specifies the font to be used for labeling the buttons.

*FvwmWinListFore color
Specifies the color to use for the button names.

*FvwmWinListBack color
Specifies the color for the buttons.

*FvwmWinListUseSkipList
Tells FvwmWinList to not show the windows that are listed on a WindowListSkip line
if the configuration file.

*FvwmWinListNoAnchor
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 window instead of the full window
name. This is useful to keep the width of the window small.

*FvwmWinListAction action response[,reponse...]
Tells FvwmWinList to do response when action is done. The currently supported
actions are: Click1, Click2, Click3. The currently supported responses are any
fvwm built-in commands, including modules and functions.

SAMPLE CONFIGURATION

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
# I like it achored
#*FvwmWinListNoAnchor

Use FvwmWinList1 online using onworks.net services