xTaskbar v1.2.3 ReadMe

• xTaskbar
• Main Settings
• Image Settings
• Icon Settings
• Font Settings
• Bangs and Events
• Examples
• Contact
• Changes.txt

Special Settings

*xTaskbar <taskbarname>
Define your own Taskbar Name, for having just more then one Taskbar.
Important: You don't need to set this, if you only need one Taskbar! (See Examples).

Settings Example with custom Taskbar(Name):
*xTaskbar Task
TaskX x-coordinate
TaskY ....

Setting example without custom Taskbar(Name):
xTaskbarX x-coordinate
xTaskbarY ....

Main Settings

• X INT
  Sets the horizontal position of the taskbar in pixels. If the value is positive then it is relative to the left side of the desktop, if negative then to the right side. Additionally you can make the position relative to the center of the desktop by appending the character 'c' after the number ("32c", "-128c") or "Real Negative Values" by adding a '~' before the number ("~10").
  Example:
  xtaskbarx ~5 is 5 Pixel LEFT from the LEFT SIDE ( Just as info, this isn't on the screen anymore ;) )
  xtaskbarx -5 is 5 Pixel LEFT from the RIGHT SIDE
• Y INT
  Sets the vertical position of the taskbar in pixels. If the value is positive then it is relative to the top of the desktop, if negative then to the bottom. Additionally you can make the position relative to the center of the desktop by appending the character 'c' after the number ("32c", "-128c") or "Real Negative Values" by adding a '~' before the number ("~10").
  Example:
  xtaskbarx ~5 is now 5 Pixel ABOVE the TOP SIDE ( Just as info, this isn't on the screen anymore ;) )
  xtaskbarx -5 is now 5 Pixel ABOVE the BOTTOM SIDE
• Width INT
  Sets the horizontal size of the taskbar. This can be an absolute value (in pixels) or a percentage of the desktop width.
• Height INT
  Sets the vertical size of the taskbar. This can be an absolute value (in pixels) or a percentage of the desktop height.
• HideIfEmpty BOOL
  If set, the taskbar hides itself, if it's empty and shows up again, if a task is added.
• AddOnlyMatching "SubString from Class or Windowname;SubString from Class or Windowname;..."
  If set!, only Tasks are shown in the Taskbar, which match ONE of the supplied Matching Strings.
  The Matching Strings support normal Wildcards and are separated with a Semicolon ";". The check is case-insensitive! You can add as many Wildcard Strings as you want/need.

  Example:
  xTaskbarAddOnlyMatching "super*;*free*"
  xTaskbar will show only Tasks, which ClassName or WindowTitle either starts with "super", or have at any place inside "free".

• RemoveOnlyMatching "SubString from Class or Windowname;SubString from Class or Windowname;..."
  If set!, Tasks, which match ONE of the supplied Matching Strings will be removed(not shown) in THIS taskbar.
  The Matching Strings support normal Wildcards and are separated with a Semicolon ";". The check is case-insensitive! You can add as many Wildcard Strings as you want/need.

  Example:
  xTaskbarRemoveOnlyMatching "super*;*free*"
  xTaskbar will not show Tasks, which ClassName or WindowTitle either starts with "super", or have at any place inside "free".

• AlwaysOnTop BOOL
  If this command is present then it makes the taskbar "always on top", that is, the taskbar stays above all application windows.
• BehindWindow "Classname" "WindowName"
  If a "Classname" (and a "Windowname") is set, the Taskbar is placed Behind this window and will never come to front.
  By Default the Taskbar never changes it's zOrder after first creation (if not AlpwaysOnTop).
• StartHidden BOOL
  If this command is present then the taskbar will be initially invisible. It can later be shown using bang commands.
• AlphaTransparency INT
  The command makes the taskbar really alphatransparent (eg. you will see the background or a window you drag below the taskbar shine through).
  Caution: This won't work on WinME or Win9x!
  Valid values are 0-255, where 0 is totally transparent and 255 is opaque.
  Default is 255.
• AlphaMap BOOL
  If this command is present then the xTaskbar uses a given AlphaChannel in the PNG images for painting per-pixel Alphatransparency.
  Caution:
  AlphaMap can only be used if an Main BG Image IS set and NO SolidColors are used for the Main BG.
  This won't work on WinME or Win9x!
  Using AlphaMap doesn't support:
  ALPHAMAP WON'T WORK WITH HOOKED XTASKBARS, except you use an AlphaMapped xLabel-3.2 (xPopup-1.0) Parent!!
• AlphaFade
  If this command is present then the taskbar will be fade in/out on Show/Hide.
  Caution:
  This won't work on WinME or Win9x!
  
• CustomAlphaFade (stepsize) (delay)
  If this command is present then the taskbar will be fade in/out on Show/Hide with the given settings.
  Caution:
  This won't work on WinME or Win9x!
  
• TransparencyMode BOOL
  If set, the Transparency (Magic Pink) will be TRUE.
• UpdateInterval INT
  Sets the Update Interval of the Taskbar Buttons to check for changes. Default is 1000 (ms), every second.
• FlashInterval INT
  Sets the Flashing Interval of the Taskbar Buttons. Default is "UpdateInterval".
• LoadInBox BOOL
  To hook the taskbar (simply hides it till it's loaded into the Parent).
• Display "flashing", "all", "normal", "active", "minimized", "normal+active", "normal+minimized" and "active+minimized"
  Defines, which Button States your Taskbar should show.
  "All" -> DEFAULT and except the case you use more than one Taskbar, you maybe shouldn't change this.
• FocusOnEnter BOOL
  If set, the Taskbar "steals" the Focus from the active window, which provides instant MouseWheel functions! The One and Only purpose of this setting.
• NoMinimizeOnClick BOOL
  If this command is present, clicking a selected TaskButton won't minimize the Application!
• NoCreateAtStartup BOOL
  Taskbar will not be created on startup.
• UseGrouping BOOL
  If this command is present, then Tasks with the same "Class" are represented by only One TaskButton. Access to all "hidden" Tasks via ".select" (normally on LeftClick a TaskButton).
• DropDelay INT
  If set, it specifies the time in ms, how long a Dragged File MUST hover over a TaskButton till he's activated (Comes to Front).
  Default is 0 (ms) -> instantly.
• UseBigIcon BOOL
  Use 32x32 Icons in TaskbarButtons instead of the 16x16 Icons.
• ShowIcon BOOL
  Show Icons in TaskbarButtons.
• ShowText BOOL
  Show Text in TaskbarButtons
• ShowTooltip BOOL
  Shows TaskButton tooltips.
• ShowHoverState BOOL
  Enables a visually change, if the Mouse hovers over a Button. Enables HoverButton Settings!
• LeftBorder INT
  Sets the number of pixels on the left edge to reserve as a border to taskbuttons. If no value is provided then the default is 0.
• TopBorder INT
  Sets the number of pixels on the top edge to reserve as a border to taskbuttons. If no value is provided then the default is 0.
• RightBorder INT
  Sets the number of pixels on the right edge to reserve as a border to taskbuttons. If no value is provided then the default is 0.
• BottomBorder INT
  Sets the number of pixels on the bottom edge to reserve as a border to taskbuttons. If no value is provided then the default is 0.
• Lines INT
  Number of TaskbarLines (horizontal Layout) or TaskbarRows (vertical Layout).
• MaxLines INT
  Sets the Maximal available count of Taskbar Lines/Rows. Restricts xTaskbarLines and !xTaskbarLines and sets the max value for xTaskbarAutoLines.
• ButtonMaxWidth INT
  Maximum width of the Taskbutton. If no value is provided then the default is $resolutionx$.
• ButtonMaxHeight INT
  Maximum height of the Taskbutton. If no value is provided then the default is 32.
• ButtonXSpacing INT
  X Space between buttons. If no value is provided then the default is 0.
• ButtonYSpacing INT
  Y Space between buttons. If no value is provided then the default is 0.
• Layout ".horizontal" or ".vertical"
  Sets the basic layout, has effects on how a Taskbar can be used, just try it to achieve what you want your taskbar should look like :)
  If no value is provided then the default is ".horizontal".
• ButtonDirection ".left", ".right", ".top" or ".bottom"
  The direction in which new tasks are added. If no value is provided then the default is ".right" (".bottom" for vertical Layout).
• ButtonWrapDirection ".top", ".bottom", ".left" or ".right"
  The direction in which new tasks are added in after a Wrap in MultiLine Taskbars.
  If no value is provided then the default is ".bottom" (".right" for vertical Layout).
• WrapCount INT
  This settings combines the former AutoLines and MinButtonWidth/Height!
  The Taskbar wraps (a new line is added) if the Tasks exceed the WrapCount.
  If no WrapCount is set, there is no AutoAdding of lines.
  If more than one Taskbar Line is set and NO WrapCount is set, then the Default WrapCount is 5.
• VWMCurrentDesktopOnly BOOL
  If set, only the Tasks are Displayed, which are on the current Desktop.
• Sort ".none", ".filename", ".classname", ".windowname"
  Sorts the Tasks alphabetically ascending with the specified method.
  Drag'n'Drop Sorting isn't possible, if an AutoSort function is used!
  Default is ".none" <-> Drag'n'Drop Sorting

Normal Images Setup

• Image IMAGE
  Sets the name of the taskbar image. This file must be in BMP or PNG format format. If no value is provided then the Taskbar is displayed either with the desktop background or is True Transparent depending to your settings.
• ImageMode "stretch", "tile", "tile-horizontal", "tile-vertical"
  Sets the method used to scale the taskbar image. If no value is provided then the default is "stretch".
• ImageLeftEdge INT
  Sets the number of pixels on the left edge of the image that will not be stretched or tiled. If no value is provided then the default is 0.
• ImageRightEdge INT
  Sets the number of pixels on the right edge of the image that will not be stretched or tiled. If no value is provided then the default is 0.
• ImageTopEdge INT
  Sets the number of pixels on the top edge of the image that will not be stretched or tiled. If no value is provided then the default is 0.
• ImageBottomEdge INT
  Sets the number of pixels on the bottom edge of the image that will not be stretched or tiled. If no value is provided then the default is 0.
• SaturationIntensity INT
  This command specifies the color saturation of the taskbar (ONLY THE MAIN TASKBAR BG).
  Minimum: 0 -> Grayscale
  Maximum: 255 -> Full Colored (Default)
  
• HueIntensity INT
  This command specifies the amount of the, in the taskbar, blended in color (ONLY THE MAIN TASKBAR BG).
  Minimum: 0 -> Nothing (Default)
  Maximum: 255
• HueColor COLOR
  This command specifies the blended in color.
  Default: FFFFFF

Solid Image Setup

Attention: Only valid, if "xTaskbarUseSolidColors" is set!

• UseSolidColors BOOL
  If set, the SolidColor Settings are enabled.
• SolidColors (bgcolor) [(lightbevelcolor)] [(darkbevelcolor)]
  Sets the colors of the Taskbar, first the BGColor, then optional Light and Dark BevelColors
• SolidBevelSize INT
  Sets the size of the painted bevel in pixels.
  Default: 0
• SolidGradientColors (color) [(color)] [(color)] ...
  If defined, a Gradient is Painted with the BackgroundColor and the specified Gradient Colors.
  (NO GRADIENT PAINTED ON BORDER!).
• SolidGradientVertical BOOL
  If set, the Gradient is painted vertical instead of horizontal.
• BorderMethod "Method"
  "Method" can be "Raised", "Sunken", "Etched", "Bump" and ".none" (Default)
  This settings draws only a rectangular Border (quite simple, but impressive), so you better use it only on rectangular TaskbarImages or together with SolidColors!

Exported Variables:
(Note that you will need to define dummy variables if you include these in scripts/rc files with standard $evar$ syntax, since when LiteStep reads these files xTaskbar has not yet added them, causing LS to think the variables are undefined.)

Only useful if used in HANDTYPED BANGS (LSXCommand) or if you use it in mzscripts or with "xLabels" special "!ParseEvars" Bang Command!
To use $evars$ in Bangs, which contain the "CURRENT" value, use the escape code %# and prefix the "!ParseEvars" Bang!
$xtaskbarcurrentwidth$ becomes %#xtaskbarcurrentwidth%# and so on ...

If you use a Custom TaskbarName or more than One, "xTaskbar" becomes naturally the name of your Taskbar!

• $xTaskbarCurrentX$
  The current horizontal position of the taskbar.
• $xTaskbarCurrentY$
  The current vertical position of the taskbar.
• $xTaskbarCurrentWidth$
  The current width of the taskbar.
• $xTaskbarCurrentHeight$
  The current height of the taskbar.
• $xTaskbarCurrentButtonCount$
  The current count of DISPLAYED buttons in the taskbar.
• $xTaskbarCurrentLines$
  The current lines/rows of the taskbar.
• $xTaskbarHoverTask$
  The current TaskTitle under the Mouse, if you are IN THE TASKBAR otherwise empty.

Overview "Button Image Settings"

The "(Button Type)" in front of each setting means, that every setting can be:
Normal, Active, Minimized, Flashing or Hover or Grouped
If you don't set any of these 6 specific modifiers, the default settings will be used for all modes.(see Examples)
If you set a setting with "Normal" then, THIS becomes Default for all other States except Hover and Grouped!!

1. You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"
2. You MUST enable "Grouped" (or Grouping in general) via the setting "xTaskbarUseGrouping"

Example:
xTaskbarButtonSaturationIntensity 70
All Button States have a SaturationIntensity of 70!
xTaskbarMinimizedButtonSaturationIntensity 70
Minimized Buttons have a SaturationIntensity of 70!

Button Image Settings

Normal Images Setup
• (Button Type)ButtonTrueTransparent BOOL
  If set, the Magic Pink Areas in the Image "Cut Out the TaskbarMainBG".
  Attention: This setting is only active, if you use "xTaskbarTransparencyMode TRUE"!
• (Button Type)ButtonImage IMAGE
  Sets the name of the TaskButton Image. This file must be in BMP or PNG format format. If no value is provided then the Taskbar is displayed with the Taskbar background.
• (Button Type)ButtonImageLeftEdge INT
  Sets the number of pixels on the left edge of the TaskButton Image that will not be stretched or tiled. If no value is provided then the default is 0.
• (Button Type)ButtonImageTopEdge INT
  Sets the number of pixels on the top edge of the TaskButton Image that will not be stretched or tiled. If no value is provided then the default is 0.
• (Button Type)ButtonImageRightEdge INT
  Sets the number of pixels on the right edge of the TaskButton Image that will not be stretched or tiled. If no value is provided then the default is 0.
• (Button Type)ButtonImageBottomEdge INT
  Sets the number of pixels on the bottom edge of the TaskButton Image that will not be stretched or tiled. If no value is provided then the default is 0.
• (Button Type)ButtonImageMode "stretch", "tile", "tile-horizontal" or "tile-vertical"
  Sets the method used to scale the TaskButton Image. If no value is provided then the default is "stretch".
• (Button Type)ButtonSaturationIntensity INT
  This command specifies the color saturation of the TaskButton.
  Minimum: 0 -> Grayscale
  Maximum: 255 -> Full Colored (Default)
  
• (Button Type)ButtonHueIntensity INT
  This command specifies the amount of the, in the TaskButton, blended in color.
  Minimum: 0 -> Nothing (Default)
  Maximum: 255
• (Button Type)ButtonHueColor COLOR
  This command specifies the blended in color.
  Default: FFFFFF

Solid Image Setup

Attention: Only valid, if "xTaskbarUse(Button Type)ButtonSolidColors" is set!

• Use(Button Type)ButtonSolidColors BOOL
  If set, the SolidColor Settings for this State are enabled.
  Example: "xTaskbarUseActiveButtonSolidColors"
• (Button Type)ButtonSolidColors (bgcolor) [(lightbevelcolor)] [(darkbevelcolor)]
  Sets the colors of the TaskbarButton, first the BGColor, then optional Light and Dark BevelColors
• (Button Type)ButtonSolidBevelSize INT
  Sets the size of the painted bevel in pixels.
  Default: 0
• (Button Type)ButtonSolidGradientColors (color) [(color)] [(color)] ...
  If defined, a Gradient is Painted with the BackgroundColor and the specified Gradient Colors.
  (NO GRADIENT PAINTED ON BORDER!).
• (Button Type)ButtonSolidGradientVertical BOOL
  If set, the Gradient is painted vertical instead of horizontal.
• (Button Type)ButtonBorderMethod "Method"
  "Method" can be "Raised", "Sunken", "Etched", "Bump" and ".none" (Default)
  This settings draws only a rectangular Border (quite simple, but impressive), so you better use it only on rectangular ButtonImages or together with SolidColors!

Overview "Icon Settings"

The "(Button Type)" in front of each setting means that every setting can be:
Normal, Active, Minimized, Flashing, Hover and Grouped
If you don't set any of these 6 specific modifiers, the default settings will be used for all modes. (see Examples)

If you set a setting with "Normal" then, THIS becomes Default for all other States except Hover and Grouped!!

1. You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"
2. You MUST enable "Grouped" (or Grouping in general) via the setting "xTaskbarUseGrouping"

Example:
xTaskbarIconX 5
All Button States have a IconX Position of 5!
xTaskbarMinimizedIconX 5
Minimized Buttons have a IconX Position of 5!

Icon Settings

• (Button Type)IconX INT
  Sets the horizontal position of the icon in the TaskButton. If the value is positive then it is relative to the left side of the TaskButton, if negative then to the right side. Additionally you can make the position relative to the center of the TaskButton by appending the character 'c' after the number ("32c", "-128c").
• (Button Type)IconY INT
  Sets the vertical position of the icon in the TaskButton. If the value is positive then it is relative to the top side of the TaskButton, if negative then to the bottom side. Additionally you can make the position relative to the center of the TaskButton by appending the character 'c' after the number ("32c", "-128c").
• (Button Type)IconSize INT
  This command specifies the Size (Width/Height) of the displayed Icon.
  Minimum: 8
  Maximum: 32
  If no value is provided then the default is 16.
• (Button Type)IconSaturationIntensity INT
  This command specifies the color saturation of the icon.
  Minimum: 0 -> Grayscale
  Maximum: 255 -> Full Colored (Default)
  
• (Button Type)IconHueIntensity INT
  This command specifies the amount of the, in the icon, blended in color.
  Minimum: 0 -> Nothing (Default)
  Maximum: 255
• (Button Type)IconHueColor COLOR
  This command specifies the blended in color.
  Default: FFFFFF

Overview "Font Settings"

The "(Button Type)" in front of each setting means that every setting can be:
Normal, Active, Minimized, Flashing, Hover and Grouped
If you don't set any of these 6 specific modifiers, the default settings will be used for all modes. (see Examples)

If you set a setting with "Normal" then, THIS becomes Default for all other States except Hover and Grouped!!

1. You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"
2. You MUST enable "Grouped" (or Grouping in general) via the setting "xTaskbarUseGrouping"

Example:
xTaskbarFontHeight 20
All Button States have a FontHeight of 20!
xTaskbarMinimizedFontHeight 20
Minimized Buttons have a Text FontHeight of 20!

Font Settings

• (Button Type)Font FONT
  Sets the name of the font used to display text. If no value is provided then the default is "Arial".
• (Button Type)FontHeight INT
  Sets the height of the font used to display the text in pixels. If no value is provided then the default is 15.
• (Button Type)FontLeftBorder INT
  Sets the number of pixels on the left edge of the TaskButton to reserve as a border. If no value is provided then the default is 0.
• (Button Type)FontRightBorder INT
  Sets the number of pixels on the right edge of the TaskButton to reserve as a border. If no value is provided then the default is 0.
• (Button Type)FontTopBorder INT
  Sets the number of pixels on the top edge of the TaskButton to reserve as a border. If no value is provided then the default is 0.
• (Button Type)FontBottomBorder INT
  Sets the number of pixels on the bottom edge of the TaskButton to reserve as a border. If no value is provided then the default is 0.
• (Button Type)FontColor COLOR
  If no value is provided then the default is 000000.
• (Button Type)FontBold BOOL
  If this command is present then the font will be bold.
• (Button Type)FontItalic BOOL
  If this command is present then the font will be italic.
• (Button Type)FontUnderline BOOL
  If this command is present then the font will be underlined.
• (Button Type)FontNoEllipsis BOOL
  If set, the "..." for too long Texts isn't displayed anymore.
• (Button Type)FontAlign "left", "right" or "center"
  Sets the horizontal text alignment. If no value is provided then the Default is "left".
• (Button Type)FontVertAlign "top", "bottom" or "center"
  Sets the vertical text alignment. If no value is provided then the default is "center".
• (Button Type)FontShadow BOOL
  If this command is present then the font has shadows.
  You can either use Shadow or OutLine, not both at the same time! Outlines override Shadows.
• (Button Type)FontShadowColor COLOR
  Sets the color used to display the text shadow. If no value is provided then the default is dark gray (808080).
• (Button Type)FontShadowX INT
  Sets the number of pixels in the horizontal direction that the shadow is offset from the rest of the text; this can be negative. If no value is provided then the default is 1.
• (Button Type)FontShadowY INT
  Sets the number of pixels in the vertical direction that the shadow is offset from the rest of the text; this can be negative. If no value is provided then the default is 1.
• (Button Type)FontOutline BOOL
  If this command is present then the text will be Outlined.
  You can either use Shadow or OutLine, not both at the same time! Outline overrides Shadow.
• (Button Type)FontOutlineColor COLOR
  Sets the color used to display the text Outline. If no value is provided then the default is dark gray (808080).

Overview

All Values in '[...]' are optional, means if you didn't specify more than ONE Taskbar, you never need to specify [TASKBARNAME]!!

The exaxt purpose of every bang should be quite obvious.

Bangs

• !xTaskbarAlwaysOnTop [TASKBARNAME] ("true"|"on", "false"|"off" or "toggle"|"switch")
  "true" or "on": Makes the Taskbar "always on top", that is, it stays above all application windows.
  "toggle" or "switch": Switches the Taskbar back and forth between the always on top and pinned to desktop states.
  "false" or "off": Pins the Taskbar to the desktop so that it stays below all application windows. This the default state and is the opposite of always on top.
• !xTaskbarCreate [TASKBARNAME]
  Create a Taskbar manually.
• !xTaskbarDestroy [TASKBARNAME]
  Destroys a Taskbar.
• !xTaskbarDisplay [TASKBARNAME] (Values, see MainSettings "xTaskbarDisplay")
  Sets the currently displayed States.
• !xTaskbarHide [TASKBARNAME]
  Hides the Taskbar, making it invisible.
• !xTaskbarLSBoxHook [TASKBARNAME]
  Called by the Parent Window to hook Taskbar. Do not call manually!
• !xTaskbarMove [TASKBARNAME] X Y [STEPS] [TIME]
  Moves the Taskbar.
  With animation, if (steps) AND (time) are also defined. STEPS are the animation steps and TIME the pause between two steps in milliseconds.
  Maximum TIME: 50ms (keep it short ;) )
• !xTaskbarMoveBy [TASKBARNAME] X Y [STEPS] [TIME]
  Lets you move the Taskbar according to its actual positioning. To keep current position set x or y to 0. Negative values move the Taskbar to left/top, positive to right/bottom.
  With animation, if (steps) AND (time) are also defined. STEPS are the animation steps and TIME the pause between two steps in milliseconds.
  Maximum TIME: 50ms (keep it short ;) )
• !xTaskbarRefresh [TASKBARNAME] SETTING NEWVALUE
  "Refreshes" the Taskbar with the updated xTaskbarsetting.

  -> You can change "EVERY" Taskbarsetting On-The-Fly without the need of a hardcoded bang!

  Examples:
  You want (On-The-Fly) another Background Image for the Taskbar, simply call this Bang:
  !xtaskbarrefresh xtaskbarimage new_image.png
  Attention:
  You need always TWO settings!
  !xtaskbarrefresh xtaskbarshowtooltips
  won't work, you must define the new setting value (e.g. false)
  !xtaskbarrefresh xtaskbarshowtooltips false
  This is like Normal Bangs only temporary till next Recycle! If you want to keep settings, you must change and save them.

• !xTaskbarReposition [TASKBARNAME] X Y WIDTH HEIGHT [STEPS] [TIME]
  Repositions (moves and resizes) the Taskbar.
  With animation, if (steps) AND (time) are also defined. STEPS are the animation steps and TIME the pause between two steps in milliseconds.
  Maximum TIME: 50ms (keep it short ;) )
• !xTaskbarRepositionBy [TASKBARNAME] X Y WIDTH HEIGHT [STEPS] [TIME]
  Repositions (moves and resizes) the Taskbar according to its actual positioning ans size.
  To keep current position set x or y to 0. Negative values move Taskbar to left/top, positive to right/bottom.
  To keep current size set cx or cy to 0. If negative, it shrinks the Taskbar about cx in width and/or cy in height. If positive, it grows the Taskbar about cx in width and/or cy in height.
  With animation, if (steps) AND (time) are also defined. STEPS are the animation steps and TIME the pause between two steps in milliseconds.
  Maximum TIME: 50ms (keep it short ;) )
• !xTaskbarResize [TASKBARNAME] WIDTH HEIGHT [STEPS] [TIME]
  Resizes the Taskbar.
  With animation, if (steps)> AND (time) are also defined. STEPS are the animation steps and TIME the pause between two steps in milliseconds.
  Maximum TIME: 50ms (keep it short ;) )
• !xTaskbarResizeBy [TASKBARNAME] WIDTH HEIGHT [STEPS] [TIME]
  Resizes the Taskbar relative to actual size.
  If negative, it shrinks the Taskbar about cx in width and/or cy in height.
  If positive, it grows the Taskbar about cx in width and/or cy in height.
  To keep current width and/or height set cx or cy to 0.
  With animation, if (steps) AND (time) are also defined. STEPS are the animation steps and TIME the pause between two steps in milliseconds.
  Maximum TIME: 50ms (keep it short ;) )
• !xTaskbarSetAlpha [TASKBARNAME] INT
  Set AlphaTransparency on the fly.
• !xTaskbarShow [TASKBARNAME]
  Shows the Taskbar, making it visible.
• !xTaskbarSwitch [TASKBARNAME] "next", "prev"
  Switch to "Next" or "Prev"ious Task in the Taskbar.
• !xTaskbarToggle [TASKBARNAME]
  Switches the Taskbar back and forth between the visible and invisible states.

Taskbar Button Events

ActionsOnButtonDown BOOL
If set, the old activation of actions on ButtonDown is used again, instead of ButtonUp.

• OnLeftClickButton ".select", ".menu", ".close", ".ontop" or ".none"
  Sets an action to perform, when the mouse left clicks a task button.
  Default is .select
• OnRightClickButton ".select", ".menu", ".close", ".ontop" or ".none"
  Sets an action to perform, when the mouse right clicks a task button.
  Default is .menu
• OnMiddleClickButton ".select", ".menu", ".close", ".ontop" or ".none"
  Sets an action to perform, when the mouse middle clicks a task button.
  Default is .none
• OnSelect ACTION
  If a TaskButton is selected (clicked in Taskbar, or selected in GroupedMenu), the ACTION is executed

Taskbar Events

• OnEnter (action)
  Sets an action to perform, when the mouse cursor enters the taskbar.
• OnLeave (action)
  Sets an action to perform, when the mouse cursor leaves the taskbar.
• OnLeftClickDown (action)
  Sets an action to perform, when the user presses the left mousebutton down on the taskbar.
• OnLeftClickUp (action)
  Sets an action to perform, when the user releases the left mousebutton on the taskbar.
• OnMiddleClickDown (action)
  Sets an action to perform, when the user presses the left mousebutton down on the taskbar.
• OnMiddleClickUp (action)
  Sets an action to perform, when the user releases the middle mousebutton on the taskbar.
• OnRightClickDown (action)
  Sets an action to perform, when the user presses the left mousebutton down on the taskbar.
• OnRightClickUp (action)
  Sets an action to perform, when the user releases the right mouse button on the taskbar.
• OnWheelDown (action)
  Sets an action to perform, when the mouse wheel scrolls down while the mouse cursor hovers over the taskbar.
• OnWheelUp (action)
  Sets an action to perform, when the mouse wheel is scrolled up while the mouse cursor hovers over the taskbar.
• OnResize (action)
  Sets an action to perform, when the taskbar has changed its size.
• OnMove (action)
  Sets an action to perform, when the taskbar has changed its position (executed after the move!).
• OnAdd (action)
  Sets an action to perform, when a task has been added.
• OnRemove (action)
  Sets an action to perform, when a task has been removed.
• OnLineAdd (action)
  "action" is executed, if a line has been added.
  (ONLY with xTaskbarAutoLines! If you call manually !xTaskbarLines you can also call manually the appropriated action.)
• OnLineRemove (action)
  "action" is executed, if a line has been removed.
  (ONLY with xTaskbarAutoLines! If you call manually !xTaskbarLines you can also call manually the appropriated action.)

Special Taskbar Settings
The following "Substring" references use the "Standard Wildcard" Syntax!

You can remove the Buttons of Applications with the following:

*xTaskbarRemove "SubString from Class or Windowname"

All Applications, which "Class" or "Windowname" match the "SubString", won't be shown in all Taskbars.

---

You can define Custom Icons for Applications with the following:

*xTaskbarIcon "SubString from Class or Windowname" "FULL Path to a (Icon-)File"

All Applications, which "Class" or "Windowname" match the "SubString", get the Icon from the choosen (Icon-)File in all Taskbars. *xTaskbarIcon supports Icon Extraction based on IconIndexNumber, so you can extract even more Icons.
Example:
*xTaskbarIcon "*free*" "c:\winnt\explorer.exe,8"
Eight Icon of Explorer.exe is used, which is in this case an "Alert Icon".

First the standard settings, which are all the same for the following examples:
xtaskbarusesolidcolors
xtaskbarbordermethod etched
xtaskbarusebuttonsolidcolors
xtaskbarbuttonbordermethod raised
xtaskbaractivebuttonbordermethod sunken
xtaskbarminimizedbuttonbordermethod bump

xtaskbarx 20
xtaskbary 20
xtaskbarwidth $resolutionx-40$ (remove this ones. if another value is used below!)
xtaskbarheight 32 (remove this ones. if another value is used below!)

xtaskbartopborder 4
xtaskbarbottomborder 4
xtaskbarleftborder 10
xtaskbarrightborder 10

xtaskbarbuttonxspacing 4
xtaskbarbuttonyspacing 2

xtaskbarbuttonmaxwidth 200

xtaskbarfontleftborder 24
xtaskbariconx 4

1. Normal SingleLine Taskbar
Guess what, you only need the standard settings :)

2. Taskbar With Two Lines horizontally filled and a Vertical Wrap with the 6th Button
xtaskbarheight 58 (we should start bigger due to second line)
xtaskbarlines 2
xtaskbarwrapcount 5 (you can also cut this out cause the Default in this case is also 5)


3. Taskbar With Two Lines vertically filled and a Horizontal Wrap
xtaskbarheight 58 (we should start bigger due to second line)
xtaskbarlines 2
xtaskbarlayout .vertical
xtaskbarwrapcount 2


4. SingleLine Taskbar, which grows on Wrap ( 4 Buttons ) vertically
xtaskbarwrapcount 4
xtaskbaronlineadd !xtaskbarresizeby 0 26
xtaskbaronlineremove !xTaskbarReSizeBy ytaskbar 0 -26


5. SingleLine Taskbar, which grows/shrinks with each added/removed Button
xtaskbarwidth 0 (we should start with zero, cause no buttons)
xtaskbaronadd !xtaskbarresizeby 200 0 (our TaskButton should be 200px width)
xtaskbaronremove !xtaskbarresizeby -200 0 (our TaskButton should be 200px width)


For all Layouts, you can define the Direction and WrapDirection with the according settings!

These 5 layouts should give you an impression how to create you desired taskbar layout.

Please report bugs, if there should be any, to:
andymon@ls-universe.info

Btw.: I'm native German, so everyone who's also German mustn't write me in English ;)

Homepage: Here you find News, Updates, and some more.
www.LS-Universe.info