MAN page from Other AfterStep-1.4-1.i386.rpm

WinList

Section: Misc. Reference Manual Pages (0.5)
Updated: Feb 2nd, 1998
Index

NAME

WinList - the AfterStep window list module

SYNOPSIS

WinList is spawned by AfterStep, so no command line invocation will work.

DESCRIPTION

The WinList module provides a widow list made up of buttons, eachcorresponding to a window that AfterStep is managing. Clicking on the buttonswith any of the three mouse buttons will either do a default action orcan be user configured. Like the other modules, WinList only workswhen AfterStep is used as the window manager.

INITIALIZATION

During initialization, WinList will scan the~/GNUstep/Library/AfterStep/winlist file to find the options that pertain to it.These options are discussed in a later section.

INVOCATION

WinList can be invoked by AfterStep during initialization by inserting theline 'Module WinList' in the ~/GNUstep/Library/AfterStep/winlist file.

WinList can also be bound to a keystroke, mouse button, or menu option tobe invoked later, in this case using 'Transient' as an argument will causeWinList to resemble the built in window list.

WinList must reside in a directory that is listed in the ModulePath optionof AfterStep for it to be executed by AfterStep.

CONFIGURATION OPTIONS

The following options can be placed in the ~/GNUstep/Library/AfterStep/winlistfile :

*WinListGeometry {+-}<X>x{+-}<Y>: Specifies the location and gravity of the WinList window. At the currenttime, size is not supported and WinList will resize itself as buttons areadded. If the NoAnchor option is not specified then the windows gravitycorner 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 willcause the window to draw up and to the left as windows are added)
*WinListFont font: Specifies the font to be used for labeling the buttons.
*WinListFore color: Specifies the color to use for the button names.
*WinListBack color: Specifies the color for the buttons.
*WinListUseSkipList: Tells WinList to not show the windows that are listed on a WindowListSkipline if the configuration file.
*WinListNoAnchor: By default, WinList will anchor the gravity corner so the window will growin the opposite direction. This undoes that option.
*WinListUseIconNames: Tells WinList to use the icon name of the window instead of the full windowname. This is useful to keep the width of the window small.
*WinListAction action response[,reponse...]: Tells WinList to do response when action is done. Thecurrently supported actions are: Click1, Click2, Click3. The currentlysupported responses are any AfterStep built-in commands, including modulesand functions.
*WinListOrientation down|across: Will make a vertical or horizontal winlist.
*WinListMaxWidth width in pixel: Sets either maxwidth for a vertical winlist or the actual width for anhorizontal "taskbar".
*WinListLeftJustify: If used, will justify to left window titles (centering is default)

SAMPLE CONFIGURATION

The following are excepts from a winlist file which describe WinListinitialization commands:

######### Pop up the window list in tranient mode on button 3 press & holdMouse 3   R   A   Module "WinList" WinList Transient########################## Window-Lister ###############################*WinListBack DarkOliveGreen*WinListFore PaleGoldenRod*WinListFont -*-new century schoolbook-bold-r-*-*-*-120-*-*-*-*-*-**WinListAction Click1 Iconify -1,Raise*WinListAction Click2 Iconify*WinListAction Click3 Module "Ident" Ident*WinListUseSkipList*WinListUseIconNames*WinListGeometry -50-85#*WinListNoAnchor*WinListMaxWidth 798# down (vertical winlist) or across (horizontal titlebar) ?*WinListOrientation across

AUTHOR

Ren'e Fichter <refic_79AATTunix.edu.sollentuna.se>

Mike Finger <mfingerAATTmermaid.micro.umn.edu>

This document was created byman2html,using the manual pages.