xTaskbar v1.1.8 ReadMe

Main Settings

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.

AlwaysOnTop BOOL
If this command is present then it makes the taskbar "always on top", that is, the taskbar stays above all application windows.

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:
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 "all", "specific", "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.
"Specific" -> Taskbar shows only the "Specific Tasks", means the taskbar is empty except the tasks which match the *xTaskbarSpecific (taskbarname) (substring) line!

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.

AutoLines BOOL
If set, xTaskbar automatically tracks the Size of the TaskButtons, to add/remove new Taskbarlines, if the Width/Height would be smaller than defined MinButtonWidth/Height.

MinButtonWidth INT
Minimum width of the Taskbutton. If no value is provided then the default is 0.

MinButtonHeight INT
Minimum height of the Taskbutton. If no value is provided then the default is 0.

MaxButtonWidth INT
Maximum width of the Taskbutton. If no value is provided then the default is $resolutionx$.

MaxButtonHeight 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.

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 MultiLine Taskbars, before they "Wrap" in "xTaskbarButtonDirection".
If no value is provided then the default is ".bottom" (".right" for vertical Layout).

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.

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.

↑

Button State Settings

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!!

You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"

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)ButtonAlphaBlend INT
Sets the amount if the Opacity of the TaskButton. If no value is provided then the default is 255.
Attention: This works only under Win2000/XP!

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!!

You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"

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"

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

You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"

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)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).

↑

Bang Commands And Events

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.

!xTaskbarLines [TASKBARNAME] INT
Sets the numner of TaskbarLines.

!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

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.)

Taskbar Special 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 Add Buttons of specific Applications To Only One Specific Taskbar:

*xTaskbarSpecific "CustomTaskbarname" "SubString from Class or Windowname"

All Applications, which "Class" or "Windowname" match the "SubString", will be shown only in the specified Taskbar.
This is sort of a Taskbarspecific *TaskbarRemove!

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.

↑

Examples

Taskbar without defined Custom Name and the same Font/Icon Settings for all buttons:

Taskbar without defined Custom Name and the same Font/Icon Settings for all buttons:
`xTaskbarX 20 xTaskbarY 50 xTaskbarWidth $resolutionx-200$ xTaskbarHeight 27 xTaskbarImage Taskbar_Background.png xTaskbarNormalButtonImage TaskbarNormal_Background.png xTaskbarActiveAlphaBlend 90 xTaskbarActiveButtonImage xTaskbarActive_Background.png xTaskbarActiveButtonImageMode tile xTaskbarFont "Verdana" xTaskbarFontHeight 16 xTaskbarFontColor CDCDCD xTaskbarIconX 2 xTaskbarIconY 10 xTaskbarIconSize 22`
Information: You see that there is missing the xTaskbarMinimized/FlashingButtonImage, if they're not set, xTaskbarNormalButtonImage will be taken. This is also on Icons and Fonts possible.


xTaskbarX 20

xTaskbarY 50

xTaskbarWidth $resolutionx-200$

xTaskbarHeight 27

xTaskbarImage Taskbar_Background.png

xTaskbarNormalButtonImage TaskbarNormal_Background.png

xTaskbarActiveAlphaBlend 90

xTaskbarActiveButtonImage xTaskbarActive_Background.png

xTaskbarActiveButtonImageMode tile

xTaskbarFont "Verdana"

xTaskbarFontHeight 16

xTaskbarFontColor CDCDCD

xTaskbarIconX 2

xTaskbarIconY 10

xTaskbarIconSize 22

Information:
You see that there is missing the xTaskbarMinimized/FlashingButtonImage, if they're not set, xTaskbarNormalButtonImage will be taken. This is also on Icons and Fonts possible.

Taskbar with defined Custom Name and the same Font Settings for all buttons:

Taskbar with defined Custom Name and the same Font Settings for all buttons:
*xTaskbar MyOwnBar MyOwnBarX 20 MyOwnBarY 50 MyOwnBarWidth $resolutionx-200$ MyOwnBarHeight 27 MyOwnBarImage Taskbar_Background.png MyOwnBarNormalButtonImage TaskbarNormal_Background.png MyOwnBarActiveAlphaBlend 90 MyOwnBarActiveButtonImage xTaskbarActive_Background.png MyOwnBarActiveButtonImageMode tile MyOwnBarFont "Verdana" MyOwnBarFontHeight 16 MyOwnBarFontColor CDCDCD MyOwnBarActiveIconX 5 MyOwnBarActiveIconY 56 MyOwnBarActiveIconSize322 MyOwnBarMinimizedIconX 32 MyOwnBarMinimizedIconY 43 MyOwnBarMinimizedIconSize 22 MyOwnBarFlashingIconX 10 MyOwnBarFlashingIconY 2 MyOwnBarFlashingIconSize 53
Information: You can add as many Taskbars as you want, just give them another name. eg: you can have one bar with only icons and one with only text!


*xTaskbar MyOwnBar

MyOwnBarX 20

MyOwnBarY 50

MyOwnBarWidth $resolutionx-200$

MyOwnBarHeight 27

MyOwnBarImage Taskbar_Background.png

MyOwnBarNormalButtonImage TaskbarNormal_Background.png

MyOwnBarActiveAlphaBlend 90

MyOwnBarActiveButtonImage xTaskbarActive_Background.png

MyOwnBarActiveButtonImageMode tile

MyOwnBarFont "Verdana"

MyOwnBarFontHeight 16

MyOwnBarFontColor CDCDCD

MyOwnBarActiveIconX 5

MyOwnBarActiveIconY 56

MyOwnBarActiveIconSize322

MyOwnBarMinimizedIconX 32

MyOwnBarMinimizedIconY 43

MyOwnBarMinimizedIconSize 22

MyOwnBarFlashingIconX 10

MyOwnBarFlashingIconY 2

MyOwnBarFlashingIconSize 53

Information:
You can add as many Taskbars as you want, just give them another name. eg: you can have one bar with only icons and one with only text!

↑

Contact

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

If you have wishes for xTaskbar tell them also, maybe I can realize them =)

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