241 lines
8.4 KiB
Groff
241 lines
8.4 KiB
Groff
.\" t
|
|
.\" @(#)FvwmTaskBar.1 6/30/96
|
|
.TH FvwmTaskBar 2.6 "June 30th, 1996"
|
|
.UC
|
|
.SH NAME
|
|
FvwmTaskBar \- the FVWM taskbar module
|
|
.SH SYNOPSIS
|
|
FvwmTaskBar is spawned by FVWM, so no command line invocation will work.
|
|
|
|
.SH DESCRIPTION
|
|
The FvwmTaskBar module provides a taskbar made up of buttons arranged by
|
|
rows, each corresponding to a window that FVWM is managing.
|
|
Clicking on first button gives focus to the corresponding toplevel window;
|
|
clicking on the middle button will hide a toplevel window; third mouse button
|
|
is reserved for a future extension (context menu).
|
|
Like the other modules, FvwmTaskBar only works when fvwm is used as the
|
|
window manager.
|
|
|
|
When started, the taskbar shows up as a single row of buttons filling the
|
|
full width of the screen, but during the work can be resized to accomodate
|
|
up to 8 rows. In adition, if the AutoStick option is used, the taskbar
|
|
will autoposition itself at the top or bottom of the screen, and can be
|
|
dragged from one position to another with a normal move operation.
|
|
|
|
The first button of the taskbar, labelled "Start" sends a "Popup
|
|
StartMenu" command to the FVWM, which can be used to pop-up a
|
|
general-purpose menu when the button is pressed.
|
|
|
|
The FvwmTaskBar also displays at the right side a window showing the
|
|
current time and the built-in incoming mail indicator.
|
|
|
|
.SH COPYRIGHTS
|
|
The FvwmTaskBar module is derivated from Mike Finger's FvwmWinList.
|
|
|
|
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.
|
|
|
|
.SH INITIALIZATION
|
|
During initialization, \fIFvwmTaskBar\fP gets configuration information
|
|
from FVWM to find the options that pertain to it.
|
|
These options are discussed in a later section.
|
|
|
|
.SH INVOCATION
|
|
FvwmTaskBar can be invoked by fvwm during initialization by inserting the
|
|
line 'Module FvwmTaskBar' in the .fvwm2rc file.
|
|
|
|
FvwmTaskBar must reside in a directory that is listed in the ModulePath
|
|
option of FVWM for it to be executed by FVWM.
|
|
|
|
.SH CONFIGURATION OPTIONS
|
|
The following options can be placed in the .fvwm2rc file
|
|
|
|
.IP "*FvwmTaskBarGeometry \fI{+-}<X>x{+-}<Y>\fP"
|
|
Specifies the location and gravity of the FvwmTaskBar window. At the
|
|
current version, size is not supported and the taskbar will resize itself
|
|
to fill the full witdh of the screen. If the AutoStick option is also
|
|
specified, the module will automatically "stick" to the top or the bottom
|
|
of the screen, whichever is closest to the geometry specification.
|
|
|
|
.IP "*FvwmTaskBarFont \fIfont\fP"
|
|
Specifies the default font to be used for labeling the buttons, when they
|
|
are not depressed. If not specified, fixed font is assumed.
|
|
|
|
.IP "*FvwmTaskBarSelFont \fIfont\fP"
|
|
Specifies the font to be used for the depressed buttons. Note that the
|
|
Start button will use always this font even if is not pressed. If this
|
|
option is not specified, the default font is used instead.
|
|
|
|
.IP "*FvwmTaskBarStatusFont \fIfont\fP"
|
|
Specifies the font to be used for the clock and tip windows. If this
|
|
option is not specified, fixed font is used.
|
|
|
|
.IP "*FvwmTaskBarFore \fIcolor\fP"
|
|
Specifies the color to use for the button names.
|
|
|
|
.IP "*FvwmTaskBarBack \fIcolor\fP"
|
|
Specifies the background color for the bar and buttons.
|
|
|
|
.IP "*FvwmTaskBarTipsFore \fIcolor\fP"
|
|
Specifies the color to be used for the text in the tips windows.
|
|
|
|
.IP "*FvwmTaskBarTipsBack \fIcolor\fP"
|
|
Specifies the background color for the tips windows.
|
|
|
|
.IP "*FvwmTaskBarGeometry \fIgeometry\fP"
|
|
This option specifies the geometry of the window (only the Y coordinate is
|
|
useful)
|
|
|
|
.IP "*FvwmTaskBarAutoStick"
|
|
This option causes the taskbar to "stick" either to the top or bottom
|
|
of the screen, whichever is closest to the initial window placement. Any
|
|
further move operation is also subject to that behaviour.
|
|
|
|
.IP "*FvwmTaskBarAutoHide"
|
|
This option causes the taskbar to disappear leaving a narrow strip at the
|
|
bottom of the screen, and reappears only when the mouse is moved to that
|
|
strip. This option automatically enables AutoStick.
|
|
|
|
.IP "*FvwmTaskBarUseSkipList"
|
|
Tells FvwmTaskBar to not show the windows that are listed on a WindowListSkip
|
|
line in the configuration file.
|
|
|
|
.IP "*FvwmTaskBarUseIconNames"
|
|
Tells FvwmTaskBar to use the icon name of the window instead of the full
|
|
window name. This is useful to keep the width of the buttons small.
|
|
|
|
.IP "*FvwmTaskBarShowTransients"
|
|
Tells FvwmTaskBar to show the application transient windows also. By default
|
|
they are not shown.
|
|
|
|
.IP "*FvwmTaskBarAction \fIaction response[,response...]\fP"
|
|
Tells FvwmTaskBar to do \fIresponse\fP when \fIaction\fP is done. The
|
|
currently supported \fIaction\fPs are: Click1, Click2, Click3. The currently
|
|
supported \fIresponse\fPs are any fvwm built-in commands, including modules
|
|
and functions.
|
|
The configuration example below shows the default values.
|
|
|
|
.IP "*FvwmTaskBarButtonWidth \fIwidth\fP"
|
|
Indicates the maximum width that window buttons should reach.
|
|
(the minimum is hardcoded at 32).
|
|
|
|
.IP "*FvwmTaskBarHighlightFocus"
|
|
If the mouse pointer is over the taskbar, the window under the current
|
|
button is active. This behavior is like the TVTWM Icon Manager or
|
|
FvwmIconMan. \fINote:\fP If you use this option combined with FollowMouse
|
|
focus style, you'll want the taskbar to be ClickToFocus.
|
|
|
|
.IP "*FvwmTaskBarShowTips"
|
|
Enables the tips windows (by default disabled).
|
|
|
|
.SH ""
|
|
|
|
The following options deal more specifically with the status indicators
|
|
displayed at the rigth of the taskbar.
|
|
|
|
.IP "*FvwmTaskBarClockFormat \fIformat-string\fP"
|
|
This option specifies the time format for the digital clock.
|
|
It is a \fIstfrtime(3)\fP compatible format string.
|
|
By default it is "%R".
|
|
|
|
.IP "*FvwmTaskBarUpdateInterval \fIseconds\fP"
|
|
Specifies how often the clock display should be refreshed, so that times of
|
|
the form HH:MM:SS can be used. By default 60 seconds.
|
|
|
|
.IP "*FvwmTaskBarBellVolume \fIvolume\fP"
|
|
This sets the volume of the bell when mail is detected.
|
|
It is a value between 0 (no bell) and 100 (maximum volume).
|
|
By default it is set to 20.
|
|
|
|
.IP "*FvwmTaskBarMailBox \fIpath\fP"
|
|
This option intructs the module to look for mail at the specified place
|
|
It is a full pathname to the user's mailbox.
|
|
By default it is \fI/var/spool/mail/$USER_LOGIN\fP.
|
|
A value of 'None' instructs the module not to have a mail indicator.
|
|
|
|
.IP "*FvwmTaskBarMailCommand \fIcommand\fP"
|
|
Specifies a \fIfvwm\fP command to be executed when double-clicking
|
|
on the mail icon.
|
|
|
|
.IP "*FvwmTaskBarIgnoreOldMail"
|
|
If set, draw no bitmap if there is no new mail.
|
|
|
|
.SH ""
|
|
The following options deal with the Start button at the left of the taskbar:
|
|
|
|
.IP "*FvwmTaskBarStartName \fIstring\fP"
|
|
This option specifies the string displayed in the Start button.
|
|
('Start' by default).
|
|
|
|
.IP "*FvwmTaskBarStartMenu \fIstring\fP"
|
|
This option specifies the popup to invoke when the start button is pressed.
|
|
('StartMenu' by default). The module send a 'Popup StartMenu' command to
|
|
the fvwm window manager.
|
|
|
|
.IP "*FvwmTaskBarStartIcon \fIicon-name\fP"
|
|
This option specifies the name of the icon to display at the left of the Start
|
|
button.
|
|
|
|
.SH SAMPLE CONFIGURATION
|
|
The following are excepts from a .fvwm2rc file which describe FvwmTaskBar
|
|
initialization commands:
|
|
|
|
.nf
|
|
.sp
|
|
#
|
|
# Start the taskbar on fvwm startup and restart
|
|
#
|
|
|
|
AddToFunc "InitFunction" "I" Module FvwmTaskBar
|
|
|
|
AddToFunc "RestartFunction" "I" Module FvwmTaskBar
|
|
|
|
#
|
|
# Set the style for the taskbar window, keep always on top of another
|
|
# windows
|
|
#
|
|
|
|
Style "FvwmTaskBar" NoTitle,BorderWidth 4, HandleWidth 4,Sticky,
|
|
StaysOnTop,WindowSkipList,CirculateSkip
|
|
|
|
#------------------------------------ taskbar
|
|
*FvwmTaskBarBack #c3c3c3
|
|
*FvwmTaskBarFore black
|
|
*FvwmTaskBarTipsBack bisque
|
|
*FvwmTaskBarTipsFore black
|
|
*FvwmTaskBarGeometry +0-1
|
|
*FvwmTaskBarFont -adobe-helvetica-medium-r-*-*-14-*-*-*-*-*-*-*
|
|
*FvwmTaskBarSelFont -adobe-helvetica-bold-r-*-*-14-*-*-*-*-*-*-*
|
|
*FvwmTaskBarStatusFont fixed
|
|
|
|
*FvwmTaskBarAction Click1 Iconify -1, Raise
|
|
*FvwmTaskBarAction Click2 Iconify +1, Lower
|
|
*FvwmTaskBarAction Click3 Iconify -1, Raise
|
|
|
|
*FvwmTaskBarUseSkipList
|
|
*FvwmTaskBarUseIconNames
|
|
*FvwmTaskBarAutoStick
|
|
*FvwmTaskBarShowTips
|
|
|
|
*FvwmTaskBarButtonWidth 180
|
|
*FvwmTaskBarBellVolume 20
|
|
*FvwmTaskBarMailBox /var/spool/mail/
|
|
*FvwmTaskBarMailCommand Exec xterm -e mail
|
|
*FvwmTaskBarClockFormat %I:%M %p
|
|
|
|
*FvwmTaskBarStartName Start
|
|
*FvwmTaskBarStartMenu StartMenu
|
|
*FvwmTaskBarStartIcon mini-exp.xpm
|
|
|
|
.sp
|
|
.fi
|
|
|
|
.SH BUGS
|
|
There is a bug report that FvwmTaskBar doesn't work well with
|
|
Autohide turned on.
|
|
|
|
.SH AUTHOR
|
|
David Barth (barth@di.epfl.ch)
|