LiteStep v. 0.24.6 documentation

written by the LiteStep Documentation Effort, August 2000
Changes.TXT

  .: introduction   .: configuration   .: installation   .: theme installation   .: theme creation   .: development   .: glossary   .: links  
  .: command   .: desktop   .: hotkey   .: litestep   .: lstime   .: 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.

Step.RC Syntax for taskbar.dll
AutoHideTaskbar [BOOL] Makes the taskbar autohide to the edge of the screen after the period of inactivity specified in AutoHideDelay.
AutoHideDelay [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

TaskbarPositioning [BOOL] When set to true you can move the Taskbar around with TaskbarX and TaskbarY.
TaskbarX [NUMBER]
TaskbarY [NUMBER] 		This allows you to set the X and Y values for placement of your taskbar.

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.
StripTaskbar [BOOL] The taskbar is shortened by 64 pixels from the right edge, allowing the Wharf to fit between the taskbar and the right screen edge.
MSTaskbar [BOOL] Sets all of the taskbars colors to use use the Windows color scheme over-riding all user-defined colors .
LSTaskbarFore [COLOR] Sets the color of the light bevel around the edge of the taskbar and task buttons, creating a 3D effect.

Default: 808080

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

Default: 404040

LSTaskbarBack [COLOR] Sets the background color of the taskbar.

Default: C0C0C0

LSTaskbarText [COLOR] Sets the color of text on the task buttons.

Default: FFFFFF

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.
TaskbarFont [FONT] Configures the Font to be used in the cell of the non-active task.
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.
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.
TaskButtonFlashSkin [IMAGE.BMP] Sets the image for the middle of the inactive task that has been updated.
TaskButtonFlashLeft [IMAGE.BMP] Sets the image for the left of the inactive task that has been updated.
TaskButtonFlashRight [IMAGE.BMP] Sets the image for the right of the inactive task that has been updated.
TaskButtonFlash [BOOL] Toggles whether or not tasks should flash when they have been updated.
LSTaskbarFlash [COLOR] Sets the color to be used when an inactive window is updated.

Default: 224 224 224

TaskTraySkin [IMAGE.BMP] Sets the image for the middle of the tray in the taskbar. This image is stretched as icons are added to the tray.
TaskTrayLeft [IMAGE.BMP] Sets the image for the left edge of the tray in the taskbar.
TaskTrayRight [IMAGE.BMP] Sets the image for the right edge of the tray in the taskbar.
TaskbarStartButton [BOOL] A Start button similar to that found on the Explorer taskbar will be placed in the left corner of the taskbar. When the Start button is pressed, the Popup menu will be displayed. Note that a Popup module must be loaded for this functionality.
StartButtonSize [NUMBER] If TaskbarStartButton is set to true, this command sets the width in pixels of the Start button.

Default: 50 pixels.

StartButtonText [STRING] If TaskbarStartButton is set to true, this command will specify a text string to be displayed on the Start button.

Default: "LiteStep"

StartButtonSkin [IMAGE.BMP] Sets the image for the middle of the Start button.
StartButtonLeft [IMAGE.BMP] Sets the image for the left edge of the Start button.
StartButtonRight [IMAGE.BMP] Sets the image for the right edge of the Start button.
!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.