LiteStep v. 0.24.6 documentation

written by the LiteStep Documentation Effort, August 2000 (stolen by Jesus_mjjg)

  .: introduction   .: configuration   .: installation   .: theme installation   .: theme creation   .: development   .: glossary   .: links  

  .: command   .: desktop   .: litestep   .: lstime   .: hotkey   .: popup   .: shortcut   .: systray   .: taskbar   .: vwm   .: wharf  

What does taskbar.dll do?

Taskbar.dll is similar to the taskbar used in the Explorer shell, by providing a list of currently running tasks and a means for minimising, maximising and switching between them. Most of the Step.RC commands for the taskbar are related to customisation of the appearance of four main components: the bar itself, the task buttons, the system tray, and the Start button, which displays the Popup menu.

As is the case with all LiteStep modules, the taskbar can be skinned through the use of either colors or images. The taskbar employs a unique method of customisation with images: each component is made up of three images, one each for the left, middle, and right of the component. This is important to allow the creation of a 3D effect on the taskbar. For example, the Start button can be customised by specifying an image for the left edge of the button, the right edge of the button, and the middle of the button.

Wednesday january 16 2002 9:38:02PM

I changed some settings name: everything begins with « Taskbar » at the moment.

Forget the start button and the systray skin at the moment. (Jesus_mjjg)

Sunday january 20 2002 0:18:21AM

Removed the systray resizing thing (may come back later), so it's more stable now.(Jesus_mjjg)

Sunday january 20 2002 11:49:55PM

Systray resizing is back.

It had nothing to do with stability, but now stability is fixed: litestep won't crash anymore if you have many trillian windows open and you close trillian main window.(Jesus_mjjg)

Step.RC Syntax for taskbar.dll

TaskbarPositioning [BOOL]

When set to true you can move the Taskbar around with TaskbarX and TaskbarY.

TaskbarAutoHide [BOOL]

Makes the taskbar autohide to the edge of the screen after the period of inactivity specified in AutoHideDelay if TaskbarPositioning is not set to true.

TaskbarAutoHideDelay [NUMBER]

The period of time in milliseconds after which the taskbar will hide to the edge of the screen.

Default: 500 milliseconds.

TaskbarEdge [Top]

Positions the taskbar across the top or bottom of the screen.

Default: Bottom.

TaskbarWidth [NUMBER]

Lets you specify the width of the taskbar.

Default: 100% of Screen Width

TaskbarHeight [NUMBER]

Lets you specify the height of the taskbar.

Default: Taskbar skin height.

TaskbarLines [NUMBER]

Number of lines of the taskbar.

Default: 1

TaskbarX [NUMBER]
TaskbarY [NUMBER]

This allows you to set the X and Y values for placement of your taskbar. Accepts negative values.

Default: 0

TaskbarKeepDesktopArea [BOOL]

The taskbar by default resizes the Desktop Area to not allow anything to appear on top of the Taskbar. However you can now disable this behavior by setting this variable to TRUE.

TaskbarMSColors [BOOL]

Sets all of the taskbars colors to use use the Windows color scheme over-riding all user-defined colors .

TaskbarFore [COLOR]

Sets the color of the light bevel around the edge of the taskbar and task buttons, creating a 3D effect.

Default: 808080

TaskbarFore2 [COLOR]

Sets the color of the dark bevel around the edge of the taskbar and task buttons, creating a 3D effect.

Default: 404040

TaskbarBack [COLOR]

Sets the background color of the taskbar.

Default: C0C0C0

TaskbarFont [FONT]

Configures the Font to be used in the cell of the non-active task.

TaskbarText [COLOR]

Sets the color of text on the non-active task.

Default: FFFFFF

TaskbarFontHeight [NUMBER]

Sets the size of the font you wish to use for non-active tasks in pixels.

TaskbarFontBold [BOOL]

Allows you to use a BOLD font on non-active tasks.

TaskbarFontItalic [BOOL]

Configures the taskbar to use an italic font on the non-active tasks.

TaskbarActiveFont [FONT]

Sets the Font to be used in the cell of the active task.

TaskbarActiveFontHeight [NUMBER]

Allows you to set the size of the font in pixels.

TaskbarActiveFontBold [BOOL]

Configures the task cell to display the active task name in BOLD text.

TaskbarActiveFontItalic [BOOL]

Sets the task cell to display the active task name in italics.

TaskbarMinFont [FONT]

Sets the Font to be used in the cell of the minimized task.

TaskbarMinFontHeight [NUMBER]

Allows you to set the size of the font in pixels.

TaskbarMinFontBold [BOOL]

Configures the task cell to display the minimized task name in BOLD text.

TaskbarMinFontItalic [BOOL]

Sets the task cell to display the minimized task name in italics.

TaskbarNoSkinShift [BOOL]

The taskbar skin will not move as a task button is pressed.

TaskbarNoTextShift [BOOL]

The text on the task buttons will not move as a taskbar button is pressed.

TaskbarSkin [IMAGE.BMP]

Sets the background image for the taskbar.

TaskbarLeft [IMAGE.BMP]

Sets the image for the left edge of the taskbar.

TaskbarRight [IMAGE.BMP]

Sets the image for the right edge of the taskbar.

TaskButtonSkin [IMAGE.BMP]

Sets the image for the middle of the inactive task buttons.

TaskButtonLeft [IMAGE.BMP]

Sets the image for the left side of the inavtive task buttons.

TaskButtonRight [IMAGE.BMP]

Sets the image for the right side of the inactive task buttons.

TaskButtonSkinActive [IMAGE.BMP]

Sets the image for the middle of the active task buttons.

TaskButtonLeftActive [IMAGE.BMP]

Sets the image for the left edge of the active task buttons.

TaskButtonRightActive [IMAGE.BMP]

Sets the image for the right edge of the active task buttons.

TaskButtonSkinMin [IMAGE.BMP]

Sets the image for the middle of the minimized task buttons.

TaskButtonLeftMin [IMAGE.BMP]

Sets the image for the left edge of the minimized task buttons.

TaskButtonRightMin [IMAGE.BMP]

Sets the image for the middle of the minimized task buttons.

TaskbarMaxTaskWidth [NUMBER]

Maximum width of taskbar tiles (windows uses 160).

Default: Taskbar width.

TaskBarBorderLeft [NUMBER]

Left border between the taskbar and the firsttask tile.

Default: 4

TaskBarBorderTop [NUMBER]

Top border between the taskbar and task tiles.

Default: 4

TaskBarBorderRight [NUMBER]

Top border between the taskbar and task tiles.

Default: 4

TaskBarBorderBottom [NUMBER]

Right border between the taskbar and the last task tile.

Default: 4

TaskBarSpacing [NUMBER]

Spacing between task tiles (horizontal and vertical).

Default: 3

TaskbarIconShow [BOOL]

Whether to show the task's icon or not.

Default: TRUE

*TaskbarIgnore [TaskClassName]

Tasks that will never be displayed. Accepts multiple entries.

*TaskbarHidden [TaskClassName]

Tasks that are hidden by default, but that will toggle with !TaskbarToggleHidden

TaskbarMinColor [COLOR]

Color for minimized tasks.

Default: 808080

TaskbarActiveColor [COLOR]

Color for active tasks.

Default: 808080

TaskBar<L><R><M>Button<Up><Down> [!BANG]

Command to be executed on mouse action with the taskbar itself (not the tasks tiles).

Example: TaskbarRButtonUp !Popup

TaskButtonFlash [BOOL]

Not working (set to FALSE for the moment).

TaskbarTrayResize [DIRECTION]

Accepts LEFT and RIGHT values (or not set). Remember that TaskbarWidth is the width of the taskbar + the width of the systray. There's no height resizing at the moment.

Default: not set

!Bang Commands for taskbar.dll

!TaskbarHide

Allows you to Hide a visible Taskbar.

!TaskbarShow

Allows you to Show a hidden Taskbar.

!TaskbarToggle

Lets you switch between a Hidden and Shown state.

!TaskbarSize [NUMBER][NUMBER]

Resizes the taskbar. Negative value(s) keep previous value(s).

Example: !TaskbarSize 100 -1 will resize only the width to 100.

!TaskbarMove [NUMBER][NUMBER]

Moves the upper left corner of the taskbar to the specified position. Negative values work too.

!TaskbarLines [NUMBER]

Dynamically change the number of lines (only tasks tiles resizing).

!TaskbarToggleHidden

Toggles whether or not the tasks on the *TaskbarHidden list are shown or not (they start hidden).