FvwmWinList(0.4h) FvwmWinList(0.4h) NAME FvwmWinList - the FVWM window list module SYNOPSIS FvwmWinList is spawned by fvwm, so no command line invoca- tion will work. DESCRIPTION The FvwmWinList module provides a widow 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 will scan the same con- figuration 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 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 The following options can be placed in the .fvwmrc file May 27th, 1995 1 FvwmWinList(0.4h) FvwmWinList(0.4h) *FvwmWinListGeometry {+-}x{+-} 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) *FvwmWinListFont font Specifies the font to be used for labeling the but- tons. *FvwmWinListFore color Specifies the color to use for the button names. *FvwmWinListBack color Specifies the color for the buttons. *FvwmWinListFocusFore 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. *FvwmWinListFocusBack 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. *FvwmWinListIconFore color Specifies the color to use for the button names for windows that are iconified. If omitted, the color from FvwmWinListFore is used. *FvwmWinListFocusBack color Specifies the color to use for the button for win- dows that are iconified. If omitted, the color from FvwmWinListBack is used. *FvwmWinListUseSkipList Tells FvwmWinList to not show the windows that are listed on a WindowListSkip line if the configura- tion file. May 27th, 1995 2 FvwmWinList(0.4h) FvwmWinList(0.4h) *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 win- dow instead of the full window name. This is use- ful to keep the width of the window small. *FvwmWinListLeftJustify 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. *FvwmWinListMinWidth width *FvwmWinListMaxWidth 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. *FvwmWinListTruncateLeft 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. *FvwmWinListTruncateRight This is the inverse of FvwmWinListTruncateLeft; it is the default action. It is provided for complete- ness. *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 May 27th, 1995 3 FvwmWinList(0.4h) FvwmWinList(0.4h) 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 *FvwmWinListMinWidth 70 *FvwmWinListMaxWidth 120 # I prefer the text centered #*FvwmWinListLeftJustify # I like it achored #*FvwmWinListNoAnchor 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 . May 27th, 1995 4