xTaskbar Docs Version 1.5.1
*xTaskbar taskbarname
Define your own Taskbar name! (Or for having more then one Taskbar.)
Important:
If you only need one Taskbar, you do not need to set this! (See Examples)
Example settings without custom Taskbar(name) (90% of the users will use xTaskbar this way!):
xTaskbarX x-coordinate xTaskbarY ....
Example settings with custom Taskbar(name), in this case "Task":
*xTaskbar Task TaskX x-coordinate TaskY ....
Key: * PlaceHolder, must be replaced with the xTaskbar name. Default is "xTaskbar". (Button Type) = PlaceHolder, can be one of the following: 1. "" (Nothing/Blank) = Default value for ALL Button States 2. "Normal" = Normal Button State 3. "Active" = Active/Selected Button State 4. "Minimized" = Minimzed Button State 5. "Flashing" = Flashing Button State 6. "Hover" = Hover Button State See Also: xTaskbarShowHoverState 7. "Pressed" = Pressed Button State See Also: xTaskbarShowPressedState 8. "Grouped" = Grouped Button State See Also: xTaskbarUseGrouping INT = Integer or whole number BOOL = Boolean Value (true or false) COLOR = Color in Hex (FFFFFF = White, 000000 = Black, ...) ACTION = Bang Commands, Applications, all Litestep can execute.
X INT
Sets the horizontal position of the Taskbar in pixels. Positive value's are relative to the left side of the desktop, negative value's are relative to the right side. You can also 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. Positive value's are relative to the top of the desktop, negative value's are relative to the bottom. You can also 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 xTaskbar.
If the value is positive then its an absolute size in pixel, if negative then its the Screen(ParentModule, when hooked) Width/Height minus the specified value. Additionally you can make the size relative to a precentage of the Screen(ParentModule, when hooked) Width/Height by appending the character '%' after the number ("50%", "-20", "50%-20", "75%+40").
Height INT
Sets the vertical size of the xTaskbar.
If the value is positive then its an absolute size in pixel, if negative then its the Screen(ParentModule, when hooked) Width/Height minus the specified value. Additionally you can make the size relative to a precentage of the Screen(ParentModule, when hooked) Width/Height by appending the character '%' after the number ("50%", "-20", "50%-20", "75%+40").
AutoSize MaxTaskbarSIZE(int) [STEPS(int)] [DELAY(int)]
The Taskbar resizes/repositions itself according to the settings!
You must additionally set:
xTaskbarButtonMaxWidth xTaskbarButtonMaxHeight
MaxTaskbarSIZE is either the maximum Width (Layout .horizontal) or Height (Layout .vertical) of the Taskbar.
STEPS and DELAY specify the Animation (you should already know how to use).
Attention:
This Feature isn't suitable for all "normal" Taskbars!
You should only use this if you want to use a Taskbar layout, which uses mainly Fixed Size Buttons. For instance Taskbars, which only contain big icons.
AlwaysOnTop BOOL
If this command is present then it makes the Taskbar "always on top". 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.
StartHidden BOOL
If this command is present then the Taskbar will be initially invisible. It can later be shown using bang commands.
HideIfEmpty BOOL
If defined, the Taskbar hides itself when it is empty, and shows up again if a task is added.
AddOnlyMatching "SubString from Class or Windowname;SubString from Class or Windowname;..."
If defined, the only Tasks that are shown in *THIS* Taskbar are the ones 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 contain at any place inside "free".
RemoveOnlyMatching "SubString from Class or Windowname;SubString from Class or Windowname;..."
If defined, the only Tasks that are removed(not shown) in *THIS* Taskbar are the ones 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:
xTaskbarRemoveOnlyMatching "super*;*free*"
xTaskbar will not show Tasks, which ClassName or WindowTitle either starts with "super", or contain at any place inside "free".
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).
Valid values are 0-255, where 0 is totally transparent and 255 is opaque.
If no value is provided then the default is 255.
Caution:
This won't work on WinME or Win9x!
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!!
AlphaFade BOOL
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 defined, the Transparency (Magic Pink) will be TRUE Transparency.
Borders LEFT RIGHT TOP BOTTOM or (LEFT/RIGHT) (TOP/BOTTOM) or (LEFT/RIGHT/TOP/BOTTOM)
Accepts 4, 2 or 1 INT Value(s), which define the borders.
A single CFG-Line variation of:
xTaskbarLeftBorder
xTaskbarRightBorder
xTaskbarTopBorder
xTaskbarBottomBorder
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.
ButtonMaxCount INT
If set, only this amount of buttons is displayed in the taskbar.
You can scroll through the "invisible" buttons with the new Bang !xTaskbarScrollButtons.
This feature WON'T work with an AutoSize Taskbar!
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 (horizontal) Space between buttons.
If no value is provided then the default is 0.
ButtonYSpacing INT
Y (vertical) Space between buttons.
If no value is provided then the default is 0.
Layout ".horizontal" or ".vertical"
Sets the basic layout, and affects how a Taskbar can be used. Play with it to achieve what you want your taskbar to 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.
UpdateInterval INT
Sets the Update Interval of the Taskbar Buttons to check for changes.
If no value is provided then the default is 1000 (ms), every second.
TrackingInterval INT
Sets the TrackingInterval, the timer, which checks for Hover Events or OnLeave Event.
If no value is provided then the default is 250 (ms).
FlashInterval INT
Sets the Flashing Interval of the Taskbar Buttons.
If no value is provided then the default is 500ms.
LoadInBox BOOL
To hook the taskbar (simply hides it until it's loaded into the Parent).
NoCreateAtStartup BOOL
Taskbar will not be created on startup.
UseBigIcon BOOL
Use 32x32 Icons in TaskbarButtons instead of the 16x16 Icons.
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).
ShowHoverState BOOL
Enables a visual change if the Mouse hovers over a Button. Also enables HoverButton Settings!
ShowPressedState BOOL
Enables a visual change if the Mouse is pressed on a Button. Also enables PressedButton Settings!
ShowIcon BOOL
Show Icons in TaskbarButtons.
If no value is provided then the default is TRUE.
ShowText BOOL
Show Text in TaskbarButtons.
If no value is provided then the default is TRUE.
ShowTooltip BOOL
Shows TaskButton tooltips.
If no value is provided then the default is TRUE.
TooltipMode METHOD
METHOD can be one of the following:
".prefix-caption-file" -> Default
".caption-file"
".prefix-caption"
".caption"
".prefix-file"
".file"
BalloonTooltip [TITLE(string)] [ICON(int)]
Gives you a big BalloonTooltip with optional Info/Warning/Error Icon with Bold Title and "Normal" Tooltip Info.
You can use:
xTaskbarBalloonTooltip --> BallonTooltip without Title and Icon xTaskbarBalloonTooltip true --> BallonTooltip without Title and Icon xTaskbarBalloonTooltip "Info:" 1 --> BallonTooltip with Title "Info:" and Info Icon xTaskbarBalloonTooltip "TaskButton Info:" --> BallonTooltip with Title "TaskButton Info:" and No Icon xTaskbarBalloonTooltip "TaskButton Info:" 0 --> BallonTooltip with Title "TaskButton Info:" and No Icon ...
TITLE is a plain title text.
ICON is an INT value:
0 = No Icon
1 = Info Icon
2 = Warning Icon -> Quite silly ;)
3 = Error Icon -> Quite silly ;)
TooltipDurations INT INT
The first INT value specifies in ms, how long the mouse must remain stationary within a taskbutton for the tooltip to show up.
The second INT value specifies in ms, how long the toolwindow is shown. ( Minimum: 1000(ms) )
TooltipColor COLOR
Color of the Tooltip and BalloonTooltip background.
TooltipTextColor COLOR
Color of the the Tooltip and BalloonTooltip Text.
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.
Sort ".none", ".filename", ".classname", ".windowname", ".zorder"
Sorts the Tasks alphabetically ascending with the specified method.
Drag'n'Drop Sorting isn't possible, if an AutoSort function is used!
If no value is provided then the default is ".none" <-> Drag'n'Drop Sorting
FocusOnEnter BOOL
If defined, the Taskbar "steals" the Focus from the active window, which provides instant MouseWheel functions! The One and Only intended purpose of this setting.
NoMinimizeOnClick BOOL
If this command is present, clicking a selected TaskButton will not minimize the Application!
VWMCurrentDesktopOnly BOOL
If defined, only the Tasks which are on the current Desktop are Displayed.
You need at least RabidVWM v1.2.1 or BangVWM v0.41!
SpecifiedMultiMonitorOnly INT
The INT is 0 to 3, where 1 is the primary Monitor, 2 the secondary, ...
Special is 0, that refers to the Monitor on which xTaskbar currently is.
In this case it should work this way:
If you move the xTaskbar from the secondary monitor to the primary, the taskbar automatically shows only the Tasks on the new monitor.
DropDelay INT
If defined, it specifies the time in ms, how long a Dragged File MUST hover over a TaskButton until he's activated (Comes to Front).
If no value is provided then the default is 0 (ms) -> instantly.
First of all, a "OverlayTaskbar" isn't a normal Taskbar, it's only a plain "Image Overlay"!
You can use OverlayTaskbar for AlphaMap Overlays, Texture Overlays, Colorizing, ...
You can combine as many OverlayTaskbar's as you want, they can overlap each other, ...
*[Taskbarname]OverlayTaskbar x y width height "SettingsPrefix" #a (0-255)
x, y, width and height
All position and sizing options of the normal xTaskbar is available to setup the position and size of the OverlayTaskbar.
For a complete and automatically adapted Overlay use for instance:
*xTaskbarOverlayTaskbar 0 0 100% 100% ghost #
or for a 20 Pixel Border on the right side without Overlay:
*xTaskbarOverlayTaskbar 0 0 -20 100% ghost #
...
"SettingsPrefix"
For all OverlayTaskbar settings you need the "SettingsPrefix", which works exactly like the "xTaskbar Name" for normal xTaskbars!
Syntax:
*xTaskbarOverlayTaskbar 10 10 24 24 ghost #
The correct Syntax for the OverlayTaskbar settings are now:
GhostImage "ghost.png" GhostSaturationIntensity 75 ...
Flags
The "a" after the # specifies that THE OVERLAY! uses an AlphaMap Image!
Last Value
The last Value specifies the overall Alpha Value for the Overlay!
All SolidColors or Image Settings are valid to setup your OverlayTaskbar Overlay!
SettingsPrefixImage ... SettingsPrefixSolidColors ...
Simply look in the following Section of the ReadMe.
BorderMethod "Raised", "Sunken", "Etched", "Bump" and ".none" (Default)
This settings draws a rectangular Border only (quite simple, but impressive), so you better use it only on rectangular TaskbarImages or together with SolidColors!
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.
HueColor COLOR
This command specifies the blended in color.
You cannot use Grayscale Colors, like FFFFFF, c0c0c0, 888888, 000000, ...., because they don't have a color!
If no value is provided then the default is "FFFFFF".
HueIntensity INT
This command specifies the color of the pixel or the blended in color if HueIntensity is smaller then 100. (ONLY THE MAIN TASKBAR BG).
Minimum: 0 -> Nothing (Default)
Maximum: 100
MixColor COLOR
This command specifies the mixed in color.
Same as the former HueColor!
If no value is provided then the default is "FFFFFF".
MixIntensity INT
This command specifies the amount of the mixed in color. (ONLY THE MAIN TASKBAR BG).
Same as the former HueIntensity (with maximum 100 instead of 255)!
Minimum: 0 -> Nothing (Default)
Maximum: 100
LuminanceIntensity INT
This command specifies the luminance of the taskbar image (ONLY THE MAIN TASKBAR BG).
Minimum: -100 -> Black
Maximum: 100 -> White
Default: 0
SaturationIntensity INT
This command specifies the color saturation of the taskbar. (ONLY THE MAIN TASKBAR BG).
Minimum: 0 -> Grayscale
Maximum: 100 -> Full Colored (Default)
Values between 101-200 override the original Saturation of the Pixel!
This way you can colorize Grayscale Images.
Attention: Only valid, if "xTaskbarUseSolidColors" is set!
UseSolidColors BOOL
If defined, 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 LEFT RIGHT TOP BOTTOM or (LEFT/RIGHT) (TOP/BOTTOM) or (LEFT/RIGHT/TOP/BOTTOM)
Accepts 4, 2 or 1 INT Value(s), which define the size of the different bevel sides.
Sets the size of the painted Bevels in pixels.
xTaskbarSolidBevelSize 1 sets all borders to 1px
xTaskbarSolidBevelSize 1 0 sets left/right borders to 1px and top/bottom borders to 0px
xTaskbarSolidBevelSize 1 0 2 1 sets left/right/top/bottom border to the defined values
If no value is provided then the default is 0.
SolidGradientType TYPE
TYPE can be:
".none" (Default: Oldstyle with (possible) multiple Gradient Colors)
".horizontal";
".vertical"
".radial"
".diagonal"
".fdiagonal"
".bdiagonal2
RESTRICTION: ONLY A TWO COLOR GRADIENT IS POSSIBLE!
SolidTransformationType TYPE
TYPE can be:
".none" (Default)
".caricature"
".fisheye"
".swirled"
".cylinder"
".shift"
RESTRICTION: ONLY VALID WITH SolidGradientType <> ".none"!
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 defined, the Gradient is painted vertical instead of horizontal.
SolidGradientRepeated INT
The Gradient colors are repeated in an endless loop over the whole xTaskbar size.
INT specifies how big (in pixels) each plain color of the gradient shall be.
(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 LiteStep 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 taskbar, "xTaskbar" naturally becomes the name of your Taskbar!
$xTaskbarCurrentHWND$
Exports the current HWND of the xTaskbar Window as an INT value! You can use it to access the xTaskbar directly via SendMessage, ....
$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.
The "(Button Type)" in front of each setting means that every setting can be:
Normal, Active, Minimized, Flashing, Hover, Pressed or Grouped
If you don't set any of these 7 specific modifiers, the default settings will be used for all modes. (See Examples)
1. You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"
2. You MUST enable "Pressed" in general via the setting "xTaskbarShowPressedState"
3. 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%!
First of all, a "OverlayButton" isn't a normal TaskbarButton, it's only a plain "Image Overlay" over the existing ones!
You can use OverlayButtons for AlphaMap Overlays, Texture Overlays, Colorizing, ...
You can combine as many OverlayButton's as you want, they can overlap each other, ...
*[Taskbarname]OverlayButton x y width height "SettingsPrefix" #a
x, y, width and height
All position and sizing options of the normal xTaskbar is available to setup the position and size of the OverlayButton.
The Overlay is always relative to the current ButtonSize, so most of the time you will probably use "100%" for width and height!
For a complete and automatically adapted Overlay use for instance:
*xTaskbarOverlayButton 0 0 100% 100% OverlayButton #
or for a 20 Pixel Border on the right side without Overlay:
*xTaskbarOverlayButton 0 0 -20 100% OverlayButton #
This would display an OverlayButton which is 6 pixel bigger then the normal button ("Glow Effect")
*xTaskbarOverlayButton ~6 ~6 100%+12 100%+12 testoverlay #a
...
SettingsPrefix
For all OverlayButton settings you need the "SettingsPrefix", which works exactly like the "xTaskbar Name" for normal xTaskbars!
Attention: If you don't set a specific State Overlay, the Overlay of this state is not the Default!, so you can for instance apply an Overlay only for the Active State.
Syntax:
*xTaskbarOverlayButton 10 10 24 24 OverlayButton #
The correct Syntax for the OverlayButton settings are now:
OverlayButtonNormalButtonImage "ghost_n.png" OverlayButtonActiveButtonImage "ghost_a.png" ...
Flags
The "a" after the # specifies that THE OVERLAY! uses an AlphaMap Image!
Supported Settings for a OverlayButton
All SolidColors or Image Settings are valid to setup your OverlayButton Overlay!
SettingsPrefixButtonImage ... SettingsPrefixButtonSolidColors ...
Simply look in the following Section of the ReadMe.
(Button Type) = PlaceHolder, can be one of the following:
1. "" (Nothing/Blank) = Default value for ALL Button States
2. "Normal" = Normal Button State
3. "Active" = Active/Selected Button State
4. "Minimized" = Minimzed Button State
5. "Flashing" = Flashing Button State
6. "Hover" = Hover Button State See Also: xTaskbarShowHoverState
7. "Pressed" = Pressed Button State See Also: xTaskbarShowPressedState
8. "Grouped" = Grouped Button State See Also: xTaskbarUseGrouping
(Button Type)ButtonBorderMethod "Raised", "Sunken", "Etched", "Bump" and ".none" (Default)
This settings draws a rectangular Border only (quite simple, but impressive), so you better use it only on rectangular ButtonImages or together with SolidColors!
(Button Type)ButtonAlphaTransparency INT
If defined, the Button has the specified AlphaTransparency.
Attention:
Do not use this without a Taskbar BG, otherwise MagicPink shines through. Either use a BG or a AlphaMap Taskbar with a fully transparent Taskbar BG.
(Button Type)ButtonTrueTransparent BOOL
If defined, the Magic Pink Areas in the Image "Cut Out" the TaskbarMainBG.
(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)ButtonHueColor COLOR
This command specifies the blended in color.
You cannot use Grayscale Colors, like FFFFFF, c0c0c0, 888888, 000000, ...., because they don't have a color!
If no value is provided then the default is "FFFFFF".
(Button Type)ButtonHueIntensity INT
This command specifies the color of the pixel or the blended in color if HueIntensity is smaller then 100.
Minimum: 0 -> Nothing (Default)
Maximum: 100
(Button Type)ButtonMixColor COLOR
This command specifies the mixed in color.
Same as the former HueColor!
If no value is provided then the default is "FFFFFF".
(Button Type)ButtonMixIntensity INT
This command specifies the amount of the mixed in color.
Same as the former HueIntensity (with maximum 100 instead of 255)!
Minimum: 0 -> Nothing (Default)
Maximum: 100
(Button Type)ButtonLuminanceIntensity INT
This command specifies the luminance of the TaskButton.
Minimum: -100 -> Black
Maximum: 100 -> White
Default: 0
(Button Type)ButtonSaturationIntensity INT
This command specifies the color saturation of the TaskButton.
Minimum: 0 -> Grayscale
Maximum: 100 -> Full Colored (Default)
Values between 101-200 override the original Saturation of the Pixel!
This way you can colorize Grayscale Images.
Attention: Only valid, if "xTaskbarUse(Button Type)ButtonSolidColors" is set!
Use(Button Type)ButtonSolidColors BOOL
If defined, 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 LEFT RIGHT TOP BOTTOM or (LEFT/RIGHT) (TOP/BOTTOM) or (LEFT/RIGHT/TOP/BOTTOM)
Accepts 4, 2 or 1 INT Value(s), which define the size of the different bevel sides.
Sets the size of the painted Bevels in pixels.
xTaskbar(Button Type)ButtonSolidBevelSize 1 sets all borders to 1px
xTaskbar(Button Type)ButtonSolidBevelSize 1 0 sets left/right borders to 1px and top/bottom borders to 0px
xTaskbar(Button Type)ButtonSolidBevelSize 1 0 2 1 sets left/right/top/bottom border to the defined values
If no value is provided then the default is 0.
(Button Type)ButtonSolidGradientType TYPE
TYPE can be:
".none" (Default: Oldstyle with (possible) multiple Gradient Colors)
".horizontal";
".vertical"
".radial"
".diagonal"
".fdiagonal"
".bdiagonal2
RESTRICTION: ONLY A TWO COLOR GRADIENT IS POSSIBLE!
(Button Type)ButtonSolidTransformationType TYPE
TYPE can be:
".none" (Default)
".caricature"
".fisheye"
".swirled"
".cylinder"
".shift"
RESTRICTION: ONLY VALID WITH SolidGradientType <> ".none"!
(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 defined, the Gradient is painted vertical instead of horizontal.
(Button Type)ButtonSolidGradientRepeated INT
The Gradient colors are repeated in an endless loop over the whole button size.
INT specifies how big (in pixels) each plain color of the gradient shall be.
The "(Button Type)" in front of each setting means that every setting can be:
Normal, Active, Minimized, Flashing, Hover, Pressed and Grouped
If you don't set any of these 7 specific modifiers, the default settings will be used for all modes. (See Examples)
1. You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"
Additionally you must enable the Hover Icon Settings explicit with "xTaskbarUseHoverIconSettings"
UseHoverIconSettings BOOL
If defined, Hover Icon Settings are enabled, otherwise current State settings are used.
2. You MUST enable "Pressed" in general via the setting "xTaskbarShowPressedState"
Additionally you must enable the Pressed Icon Settings explicit with "xTaskbarUsePressedIconSettings"
UsePressedIconSettings BOOL
If defined, Pressed Icon Settings are enabled, otherwise current State settings are used.
3. You MUST enable "Grouped" (or Grouping in general) via the setting "xTaskbarUseGrouping"
Additionally you must enable the Grouped Icon Settings explicit with "xTaskbarUseGroupedIconSettings"
UseGroupedIconSettings BOOL
If defined, Grouped Icon Settings are enabled, otherwise current State settings are used.
Example:
xTaskbarIconX 5
All Button States have a IconX Position of 5!
xTaskbarMinimizedIconX 5
Minimized Buttons have a IconX Position of 5!
(Button Type) = PlaceHolder, can be one of the following:
1. "" (Nothing/Blank) = Default value for ALL Button States
2. "Normal" = Normal Button State
3. "Active" = Active/Selected Button State
4. "Minimized" = Minimzed Button State
5. "Flashing" = Flashing Button State
6. "Hover" = Hover Button State See Also: xTaskbarShowHoverState and xTaskbarUseHoverIconSettings
7. "Pressed" = Pressed Button State See Also: xTaskbarShowPressedState and xTaskbarUsePressedIconSettings
8. "Grouped" = Grouped Button State See Also: xTaskbarUseGrouping and xTaskbarUseGroupedIconSettings
(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: 64
If no value is provided then the default is 16.
See also: xTaskbarUseBigIcon
(Button Type)IconHueColor COLOR
This command specifies the blended in color.
You cannot use Grayscale Colors, like FFFFFF, c0c0c0, 888888, 000000, ...., because they don't have a color!
If no value is provided then the default is "FFFFFF".
(Button Type)IconHueIntensity INT
This command specifies the color of the pixel or the blended in color if HueIntensity is smaller then 100.
Minimum: 0 -> Nothing (Default)
Maximum: 100
(Button Type)IconMixColor COLOR
This command specifies the mixed in color.
Same as the former HueColor!
If no value is provided then the default is "FFFFFF".
(Button Type)IconMixIntensity INT
This command specifies the amount of the mixed in color.
Same as the former HueIntensity (with maximum 100 instead of 255)!
Minimum: 0 -> Nothing (Default)
Maximum: 100
(Button Type)IconLuminanceIntensity INT
This command specifies the luminance of the displayed Icon.
Minimum: -100 -> Black
Maximum: 100 -> White
Default: 0
(Button Type)IconSaturationIntensity INT
This command specifies the color saturation of the displayed Icon.
Minimum: 0 -> Grayscale
Maximum: 100 -> Full Colored (Default)
Values between 101-200 override the original Saturation of the Pixel!
This way you can colorize Grayscale Icons.
The "(Button Type)" in front of each setting means that every setting can be:
Normal, Active, Minimized, Flashing, Hover, Pressed and Grouped
If you don't set any of these 7 specific modifiers, the default settings will be used for all modes. (See Examples)
1. You MUST enable "Hover" in general via the setting "xTaskbarShowHoverState"
Additionally you must enable the Hover Font Settings explicit with "xTaskbarUseHoverFontSettings"
UseHoverFontSettings BOOL
If defined, Hover Font Settings are enabled, otherwise current State settings are used.
2. You MUST enable "Pressed" in general via the setting "xTaskbarShowPressedState"
Additionally you must enable the Pressed Font Settings explicit with "xTaskbarUsePressedFontSettings"
UsePressedFontSettings BOOL
If defined, Pressed Font Settings are enabled, otherwise current State settings are used.
3. You MUST enable "Grouped" (or Grouping in general) via the setting "xTaskbarUseGrouping"
Additionally you must enable the Grouped Font Settings explicit with "xTaskbarUseGroupedFontSettings"
UseGroupedFontSettings BOOL
If defined, Grouped Font Settings are enabled, otherwise current State settings are used.
Example:
xTaskbarFontHeight 20
All Button States have a FontHeight of 20!
xTaskbarMinimizedFontHeight 20
Minimized Buttons have a Text FontHeight of 20!
Scrolling ButtonText, if Text is too long for the Taskbutton:
FontScroll BOOL
If set, the TaskbarButton Text (if it is too long) scrolls as long the mouse hovers over the button.
FontScrollInterval INT
Sets the scrolling update interval in milliseconds.
If no value is provided then the default is 100.
FontScrollSpeed INT
Sets the number of pixels to scroll for each update.
If no value is provided then the default is 2.
FontScrollPad INT
Sets the the number of pixels between the start and end of the text when scrolling.
If no value is provided then the default is 10.
(Button Type) = PlaceHolder, can be one of the following:
1. "" (Nothing/Blank) = Default value for ALL Button States
2. "Normal" = Normal Button State
3. "Active" = Active/Selected Button State
4. "Minimized" = Minimzed Button State
5. "Flashing" = Flashing Button State
6. "Hover" = Hover Button State See Also: xTaskbarShowHoverState and xTaskbarUseHoverFontSettings
7. "Pressed" = Pressed Button State See Also: xTaskbarShowPressedState and xTaskbarUsePressedFontSettings
8. "Grouped" = Grouped Button State See Also: xTaskbarUseGrouping and xTaskbarUseGroupedFontSettings
(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)FontCharSet CHARSET
Sets the used CharSet of the font.
ANSI_CHARSET
BALTIC_CHARSET
CHINESEBIG5_CHARSET
DEFAULT_CHARSET
EASTEUROPE_CHARSET
GB2312_CHARSET
GREEK_CHARSET
HANGUL_CHARSET
MAC_CHARSET
RUSSIAN_CHARSET
SHIFTJIS_CHARSET
SYMBOL_CHARSET
TURKISH_CHARSET
VIETNAMESE_CHARSET
JOHAB_CHARSET
ARABIC_CHARSET
HEBREW_CHARSET
THAI_CHARSET
OEM_CHARSET
If no value is provided then the default is DEFAULT_CHARSET.
(Button Type)FontTextFade LEFT RIGHT TOP BOTTOM or (LEFT/RIGHT) (TOP/BOTTOM) or (LEFT/RIGHT/TOP/BOTTOM)
Accepts 4, 2 or 1 INT Value(s), which define the number of pixels on which the text fades out at the sides of the taskbar button. Use additionally "xTaskbarFontNoEllipsis" to remove the "..." at the end!
(Button Type)FontSmoothing BOOL
AntiAliased Font Rendering (as it always was before v1.2.6).
If no value is provided then the default is TRUE.
(Button Type)FontCleartype BOOL
"ClearType" Font Rendering (just better AntiAliasing, only for WinXP).
If no value is provided then the default is TRUE.
(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
Sets the color used to display the text.
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 defined, 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").
All Values in '[...]' are optional, means if you didn't specify more than ONE Taskbar, you never need to specify [TASKBARNAME]!!
[TASKBARNAME] must naturally be replaced with the current Taskbarname, you want to be affected!
The exact purpose of every bang should be quite obvious.
!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: 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 this 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 current 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! This is like Normal Bangs only temporary until next Recycle! If you want to keep settings, you must change and save them.
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
!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 current positioning and 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 currnet 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 ;) )
!xTaskbarScrollButtons [TASKBARNAME] "next"/"prev" (amount)
If xTaskbarButtonMaxCount is set, you can scroll through the buttons with this Bang, "amount" is optional (default is 1).
!xTaskbarSetAlpha [TASKBARNAME] INT [STEPS] [TIME]
Set AlphaTransparency on the fly.
With Fade Animation, if (STEPS) AND (TIME) are also defined. STEPS are the fade steps and TIME the pause between two steps in milliseconds.
!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.
ActionsOnButtonDown BOOL
If defined, the activation of actions on ButtonDown is used, instead of ButtonUp.
OnLeftClickButton ".select", ".menu", ".close", ".ontop" or ".none"
Sets an action to perform, when the mouse left clicks a task button.
If no value is provided then the default is ".select".
OnRightClickButton ".select", ".menu", ".close", ".ontop" or ".none"
Sets an action to perform, when the mouse right clicks a task button.
If no value is provided then the default is ".menu".
OnMiddleClickButton ".select", ".menu", ".close", ".ontop" or ".none"
Sets an action to perform, when the mouse middle clicks a task button.
If no value is provided then the default is ".none".
OnSelect ACTION
If a TaskButton is selected (clicked in Taskbar, or selected in GroupedMenu), the ACTION is executed.
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 middle 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 right 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.
See also: xTaskbarFocusOnEnter
OnWheelUp ACTION
Sets an action to perform when the mouse wheel scrolls up while the mouse cursor hovers over the taskbar.
See also: xTaskbarFocusOnEnter
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
Sets an action to perform when a line has been added.
OnLineRemove ACTION
Sets an action to perform when a line has been removed.
BecomesFilled ACTION
Same as "HideIfEmpty" just with the difference that the themer can decide what should happen when the first taskbutton is shown.
BecomesEmpty ACTION
Same as "HideIfEmpty" just with the difference that the themer can decide what should happen when the last taskbutton is hides.
OnFlash ACTION
Sets an action to perform when a flashing task is started for the FIRST time.
The following "Substring" references use the "Standard Wildcard" Syntax!
*xTaskbarRemove "SubString from Class or Windowname"
All Applications, which "Class" or "Windowname" match the "SubString", will not be shown in any Taskbars.
Example:
*xTaskbarRemove "*free*"
All Applications, which have the string "free" somewhere in their Classname or Windowname, will be ignored from xTaskbar.
*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"
All Applications, which have the string "free" somewhere in their Classname or Windowname, get the Eight Icon of Explorer.exe, 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 setting, if another value is used below!) xTaskbarheight 32 (remove this setting, 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 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 your desired taskbar layout.
A little Example, which shows TWO Taskbars and the use of xTaskbarDisplay:
*xTaskbar tbleft *xTaskbar tbright tbleftx 2 tblefty 2 tbleftwidth 152 tbleftheight $resolutiony/2$ tbleftlayout .vertical tbleftdisplay "normal+minimized" tbleftusesolidcolors tbleftsolidcolors c0c0c0 000000 tbleftsolidbevelsize 1 tbleftusebuttonsolidcolors tbleftbuttonmaxheight 24 tbleftleftborder 2 tbleftrightborder 2 tblefttopborder 2 tbleftbottomborder 2 tbleftfontleftborder 20 tblefticonx 2 tbrightx 154 tbrighty 2 tbrightwidth 152 tbrightheight 24 tbrightdisplay "active" tbrightusesolidcolors tbrightusebuttonsolidcolors tbrightleftborder 2 tbrightrightborder 2 tbrighttopborder 2 tbrightbottomborder 2 tbrightfontleftborder 20 tbrighticonx 2
If you want a autosizing Taskbar, with Taskbuttons that have a exact size (eg. 64x64), do this:
Use xTaskbarAutoSize or:
The Taskbutton Width and Height are automatically calculated, so your xTaskbarWidth must EXACTLY match the following calculation.
((xTaskbarWidth-xTaskbarLeftBorder-xTaskbarRightBorder)-(ButtonCount-1)*xTaskbarButtonxSpacing)/ButtonCount
If the rest of this calculation is 0, then all Taskbuttons have all the exact same size (the result).
Explicit Example:
The Taskbuttons are 64x64, centered at the top if the screen and grow towards each side of the screen. The xSpacing between the buttons is 6.
xTaskbarHideIfEmpty xTaskbarx 0c xTaskbary 5 xTaskbarWidth 0 xTaskbarHeight 64 xTaskbarButtonMaxWidth 64 (you don't need this, if the calculation is exact) xTaskbarButtonMaxHeight 64 (you don't need this, if the calculation is exact) xTaskbarTransparencyMode true xTaskbarLeftBorder 3 xTaskbarRightBorder 3 xTaskbarButtonxSpacing 6 xTaskbarUseBigIcon xTaskbarIconSize 64 xTaskbarShowText false xTaskbarOnAdd !xTaskbarRepositionBy -35 0 70 0 xTaskbarOnRemove !xTaskbarRepositionBy 35 0 -70 0
One tricky point is important!
You must add the xSpacing together with the desired ButtonWidth, but the FIRST Button doesn't need this! If you don't care it may bother you later :P
2 Solutions:
1. Start with a Width of 0 and use LeftBorder and RightBorder so that they are together as big as your xSpacing.
2. Don't use a xSpacing and add/remove only the desired Width (64)
The above calculation in details:
First Button: ((70-3-3)-(1-1)*6)/1 -> 64/1 == 64 rest 0
Second Button: ((140-3-3)-(2-1)*6)/2 -> 128/2 == 64 rest 0
Third Button: ((210-3-3)-(3-1)*6)/3 -> 192/3 == 64 rest 0
...
If you refer to this, you can achieve all you want :)
Please report bugs, if there should be any, to:
andymon at ls-universe dot info
Homepage:
http://www.ls-universe.info/
Here you find News, Updates, and some more.