xTray v0.9.9 ReadMe

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

Overview

First of all, this is NO vTray with a 'x' instead of a 'v'!!
So you cannot use your old vTray or Systray(2) Settings and quickly switch over to xTray! You have to start more or less from start.

Why should I switch to xTray?

• AlphaMap xTray
• AlphaFading and AlphaTransparent xTray
• WinXP/2000 InfoTip Support ( More or Less ;) )
• Old XP Tray problem with Pink Icons is fixed
• Hover Icon Effects
• Drag'n'Drop Positioning of TrayIcons
• MouseWheel Scrolling through Icons (not in AutoSizeMode!)
• Easy De- and Reactivation of unwanted TrayIcons
• xModule Refresh Support
• Animated Moving/Resizing
• All Icon States and Images can have different Saturation and Hueing
• All Icon, Image, Gradient features you know from xModules
• More events
• And some other features, some may find useful

Main Settings

Key:
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.

• xTrayLoadInBox BOOL
  MUST be set to hook the Tray in another Module!
• xTrayX INT
  Sets the horizontal position of the Tray 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:
  xTrayx ~5 is 5 Pixel LEFT from the LEFT SIDE ( Just as info, this isn't on the screen anymore ;) )
  xTrayx -5 is 5 Pixel LEFT from the RIGHT SIDE
• xTrayY INT
  Sets the vertical position of the Tray 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:
  xTrayx ~5 is now 5 Pixel ABOVE the TOP SIDE ( Just as info, this isn't on the screen anymore ;) )
  xTrayx -5 is now 5 Pixel ABOVE the BOTTOM SIDE
• xTrayAutoSize [INT] [INT]
  If this command is present then the Tray will automatically ReSize(RePosition) itself to hold up the inital position and needed size.
  If the optional two INT values are specified, those will set the Animation STEPS and DELAY of the Resize(RePosition) Process.
  xTrayAutoSize 20 20 would use 20 STEPS with a DELAY of 20ms for the Aniamtion!
  Caution:
  This deactivates "xTrayWidth" and "xTrayHeight"!
  The Position is automatically adapted, based on the "xTrayDirection" and "xTrayWrapDirection"!
  That means, if you specify xTrayDirection .left the Tray Starts at "xTrayX" and grows to the LEFT, you DON'T need to reposition it (it's the normal behaviour of all AutoSizing Trays).
  If you specify xTrayWrapDirection .top the Tray Starts at "xTrayY" and grows to the TOP, you DON'T need to reposition it (it's the normal behaviour of all AutoSizing Trays).
  
• xTrayWidth INT
  Sets the horizontal size of the Tray. If the value is positive then its an absolute size in pixel, if negative then its the Screen(Parentlabel) Width minus the specified value. Additionally you can make the size relative to a precentage of the Screen(Parentlabel) Width by appending the character '%' after the number ("50%", "-20")..
• xTrayHeight INT
  Sets the vertical size of the Tray. If the value is positive then its an absolute size in pixel, if negative then its the Screen(Parentlabel) Height minus the specified value. Additionally you can make the size relative to a precentage of the Screen(Parentlabel) Height by appending the character '%' after the number ("50%", "-20").
• xTrayAlwaysOnTop BOOL
  If this command is present then it makes the Tray "always on top". The Tray stays above all application windows.
• xTrayBehindWindow "Classname" "WindowName"
  If a "Classname" (and a "Windowname") is set, the Tray is placed Behind this window and will never come to front.
  By Default the Tray never changes it's zOrder after first creation (if not AlwaysOnTop).
• xTrayStartHidden BOOL
  If this command is present then the Tray will be initially invisible. It can later be shown using bang commands.
• xTrayHideIfEmpty BOOL
  If defined, the Tray hides itself when it is empty, and shows up again if a TrayIcon is added.
• xTrayAlphaTransparency INT
  The command makes the Tray really alphatransparent (eg. you will see the background or a window you drag below the Tray 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!
• xTrayAlphaMap BOOL
  If this command is present then the xTray 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 XTRAYS!!
• xTrayAlphaFade BOOL
  If this command is present then the Tray will be fade in/out on Show/Hide.
  Caution:
  This won't work on WinME or Win9x!
  
• xTrayCustomAlphaFade (STEPSIZE) (DELAY)
  If this command is present then the Tray will be fade in/out on Show/Hide with the given settings.
  Caution:
  This won't work on WinME or Win9x!
  
• xTrayTransparencyMode BOOL
  If defined, the Transparency (Magic Pink) will be TRUE Transparency.
• xTrayBorders 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 (in AutoSize Mode).
  A single CFG-Line variation of:
  xTrayLeftBorder
  xTrayRightBorder
  xTrayTopBorder
  xTrayBottomBorder
  
• xTrayLeftBorder INT
  Sets the number of pixels on the left edge to reserve as a border to TrayIcons.
  If no value is provided then the default is 0.
• xTrayTopBorder INT
  Sets the number of pixels on the top edge to reserve as a border to TrayIcons.
  If no value is provided then the default is 0.
• xTrayRightBorder INT
  Sets the number of pixels on the right edge to reserve as a border to TrayIcons.
  If no value is provided then the default is 0.
• xTrayBottomBorder INT
  Sets the number of pixels on the bottom edge to reserve as a border to TrayIcons.
  If no value is provided then the default is 0.
• xTrayLines INT
  Number of TrayLines (horizontal Layout) or TrayRows (vertical Layout).
• xTrayMaxLines INT
  Sets the Maximal available count of Tray Lines/Rows. Restricts xTrayLines.
• xTrayXSpacing INT
  X (horizontal) Space between buttons.
  If no value is provided then the default is 0.
• xTrayYSpacing INT
  Y (vertical) Space between buttons.
  If no value is provided then the default is 0.
• xTrayLayout ".horizontal" or ".vertical"
  Sets the basic layout, and affects how a Tray can be used. Play with it to achieve what you want your Tray to look like :)
  If no value is provided then the default is ".horizontal".
• xTrayDirection ".left", ".right", ".top" or ".bottom"
  The direction in which new Trayicons are added.
  If no value is provided then the default is ".right" (".bottom" for vertical Layout).
• xTrayWrapDirection ".top", ".bottom", ".left" or ".right"
  The direction in which new Trayicons are added in after a Wrap in MultiLine Trays.
  If no value is provided then the default is ".bottom" (".right" for vertical Layout).
• xTrayWrapCount INT
  This settings combines the former AutoLines and MinButtonWidth/Height! The Tray wraps (a new line is added) if the Trayicons exceed the WrapCount.
  If no WrapCount is set, there is no AutoAdding of lines.
  If more than one Tray Line is set and NO WrapCount is set, then the Default WrapCount is 5.
• xTrayShowTooltip BOOL
  Show TrayIcon Tooltips (if set to FALSE, this deactivates also "xTrayShowInfoTip"!)
  If no value is provided then the default is TRUE.
• xTrayShowInfoTip BOOL
  Shows XP TrayIcon Infotips additionally to "Normal" Tooltips.
  Works only on Win2000 and WinXP
• xTrayBalloonTooltip BOOL
  If set, the normal Tooltips are BallonTooltips like the InfoTips, just without Title and Icon!
• xTrayTooltipDurations INT INT
  The first INT value specifies in ms, how long the mouse must remain stationary within a trayicon for the tooltip to show up.
  The second INT value specifies in ms, how long the toolwindow is shown. ( Minimum: 1000(ms) )
• xTrayTooltipColor COLOR
  Set the Background Color of Tooltips and InfoTips
• xTrayTooltipTextColor COLOR
  Set the Text Color of Tooltips and InfoTips
• xTrayCleanUpInterval INT
  Sets the amount of time in milliseconds between checks for "Crashed" TrayIcons.
  If no value is provided then the default is 10000 (10 seconds).
  
• xTrayMoveable BOOL
  If this it set the Tray is moveable with the left Mouse on the Border (if no LeftClick Action is set!)
  
• xTrayDisableDragnDrop BOOL
  Simply disables completely the manual repositioning of the TrayIcons.
• xTrayFocusOnEnter BOOL
  If defined, the Tray "steals" the Focus from the active window, which provides instant MouseWheel functions! The One and Only intended purpose of this setting.
• xTrayAlwaysFireClickEvents BOOL
  If defined the Button Click Events are fired, even if a TrayIcon was clicked!

Normal Images Setup

• xTrayImage IMAGE
  Sets the name of the Tray image. This file must be in BMP or PNG format format.
  If no value is provided then the Tray is displayed either with the desktop background or is True Transparent depending to your settings.
• xTrayImageMode "stretch", "tile", "tile-horizontal", "tile-vertical"
  Sets the method used to scale the Tray image.
  If no value is provided then the default is "stretch".
• xTrayImageLeftEdge 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.
• xTrayImageRightEdge 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.
• xTrayImageTopEdge 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.
• xTrayImageBottomEdge 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.
• xTraySaturationIntensity INT
  This command specifies the color saturation of the Tray. (ONLY THE MAIN Tray BG).
  Minimum: 0 -> Grayscale
  Maximum: 255 -> Full Colored (Default)
• xTrayHueIntensity INT
  This command specifies the amount of the blended in color of the Tray. (ONLY THE MAIN Tray BG).
  Minimum: 0 -> Nothing (Default)
  Maximum: 255
• xTrayHueColor COLOR
  This command specifies the blended in color.
  If no value is provided then the default is "FFFFFF".

Solid Image Setup

• xTraySolidColors (bgCOLOR) [(lightbevelCOLOR)] [(darkbevelCOLOR)]
  Sets the colors of the Tray, first the BGColor, then optional Light and Dark BevelColors.
• xTraySolidBevelSize 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 bevel in pixels.
  

  xTraySolidBevelSize 1	sets all borders to 1px
  xTraySolidBevelSize 1 0	sets left/right borders to 1px and top/bottom borders to 0px
  xTraySolidBevelSize 1 0 2 1	sets left/right/top/bottom border to the defined values

  If no value is provided then the default is 0.
• xTraySolidGradientColors (COLOR) [(COLOR)] [(COLOR)] ...
  If defined, a Gradient is Painted with the BackgroundColor and the specified Gradient Colors. (NO GRADIENT PAINTED ON BORDER!).
• xTraySolidGradientVertical BOOL
  If defined, the Gradient is painted vertical instead of horizontal.
• xTraySolidGradientRepeated INT
  The Gradient colors are repeated in an endless loop over the whole xTray size.
  INT specifies how big (in pixels) each plain color of the gradient shall be.
• xTrayBorderMethod "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 TrayImages 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 xTray 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!
$xTrayCurrentWidth$ becomes %#xTrayCurrentWidth%# and so on ...

• $xTrayCurrentHWND$
  The current HWND of the xTrayWindow as a int value.
  Code Example:
  int handle = GetRCInt("xTrayCurrentHWND", 0);
if (handle != 0)
{
HWND xTrayhWnd = (HWND) handle;
ShowWindow(xTrayhWnd, SW_HIDE);
}
• $xTrayCurrentX$
  The current horizontal position of the Tray.
• $xTrayCurrentY$
  The current vertical position of the Tray.
• $xTrayCurrentWidth$
  The current width of the Tray.
• $xTrayCurrentHeight$
  The current height of the Tray.
• $xTrayCurrentIconCount$
  The current count of DISPLAYED buttons in the Tray.
• $xTrayCurrentLines$
  The current lines/rows of the Tray.

Overview "Icon Settings"

• xTrayIconSize 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.
• xTrayIconSaturationIntensity INT
  This command specifies the color saturation of the icon.
  Minimum: 0 -> Grayscale
  Maximum: 255 -> Full Colored (Default)
• xTrayIconHueIntensity INT
  This command specifies the amount of the blended in color of the icon.
  Minimum: 0 -> Nothing (Default)
  Maximum: 255
• xTrayIconHueColor COLOR
  This command specifies the blended in color of the Icon.
  If no value is provided then the default is "FFFFFF".
• xTrayHoverIconSize INT
  This command specifies the Size (Width/Height) of the displayed Hover Icon.
  Make sure you have enough place in the Tray for the HoverIcon, cause the HoverIconSize isn't tracked for AutoSize!
  Minimum: 8
  Maximum: 64
  If no value is provided then the default is 16.
• xTrayHoverIconSaturationIntensity INT
  This command specifies the color saturation of the Hover Icon.
  Minimum: 0 -> Grayscale
  Maximum: 255 -> Full Colored (Default)
• xTrayHoverIconHueIntensity INT
  This command specifies the amount of the blended in color of the Hover Icon.
  Minimum: 0 -> Nothing (Default)
  Maximum: 255
• xTrayHoverIconHueColor COLOR
  This command specifies the blended in color of the Hover Icon.
  If no value is provided then the default is "FFFFFF".

Bang Commands

The exact purpose of every bang should be quite obvious.

• !xTrayAlwaysOnTop ("true"|"on", "false"|"off" or "toggle"|"switch")
  "true" or "on": Makes the Tray "always on top". That is, it stays above all application windows.
  "toggle" or "switch": Switches the Tray back and forth between the always on top and pinned to desktop states.
  "false" or "off": Pins the Tray to the desktop so that it stays below all application windows. This the default state and is the opposite of always on top.
• !xTrayHide
  Hides the Tray, making it invisible.
• !xTrayLSBoxHook
  Called by the Parent Window to hook xTray. Do not call manually!
  xTrayLoadInBox MUST be set to hook the Tray in another Module!
• !xTrayMove X Y [STEPS] [TIME]
  Moves the Tray.
  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 ;) )
• !xTrayMoveBy X Y [STEPS] [TIME]
  Lets you move the Tray according to its current positioning. To keep current position set x or y to 0. Negative values move the Tray 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 ;) )
• !xTrayRefresh SETTING NEWVALUE
  "Refreshes" the Tray with the updated xTraysetting.

  You can change "EVERY" Traysetting 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 Tray, simply call this Bang:
  !xTrayrefresh xTrayimage new_image.png

  Attention:
  You need always TWO settings!
  !xTrayRefresh xTrayShowTooltips
  won't work, you must define the new setting value (e.g. false)
  !xTrayRefresh xTrayShowTooltips false
  

• !xTrayReposition X Y WIDTH HEIGHT [STEPS] [TIME]
  Repositions (moves and resizes) the Tray.
  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 ;) )
• !xTrayRepositionBy X Y WIDTH HEIGHT [STEPS] [TIME]
  Repositions (moves and resizes) the Tray according to its current positioning and size.
  To keep current position set x or y to 0. Negative values move Tray to left/top, positive to right/bottom.
  To keep current size set cx or cy to 0. If negative, it shrinks the Tray about cx in width and/or cy in height. If positive, it grows the Tray 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 ;) )
• !xTrayResize WIDTH HEIGHT [STEPS] [TIME]
  Resizes the Tray.
  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 ;) )
• !xTrayResizeBy WIDTH HEIGHT [STEPS] [TIME]
  Resizes the Tray relative to current size.
  If negative, it shrinks the Tray about cx in width and/or cy in height.
  If positive, it grows the Tray 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 ;) )
• !xTrayScrollIcons "next" or "prev" [AMOUNT]
  Scrolls the Icons back and forth. This works only, if NO xTrayAutoSize is set!
  The optional AMOUNT, specifies how many Icons will be scrolled.
  If the AMOUNT reaches/exceeds the first or last Icon, the current Scroll will stop there.
• !xTraySetAlpha 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.
• !xTrayShow
  Shows the Tray, making it visible.
• !xTrayToggle
  Switches the Tray back and forth between the visible and invisible states.
• !xTrayToggleHiddenIcons
  Switches the Tray back and forth between the visible and invisible state of Hidden TrayIcons.
  Remember:
  You can Hide TrayIcons with *xTrayHide or by Pressing CTRL and MiddleClick the Icon.
  You can Show Hidden TrayIcons by Pressing CTRL and MiddleClick the Icon (use !xTrayToggleHiddenIcons to show them first).

Tray Events

xTrayAlwaysFireClickEvents BOOL
If defined the Button Click Events are fired, even if a TrayIcon was clicked!

• xTrayOnEnter ACTION
  Sets an action to perform when the mouse cursor enters the Tray.
• xTrayOnLeave ACTION
  Sets an action to perform when the mouse cursor leaves the Tray.
• xTrayOnLeftClickDown ACTION
  Sets an action to perform when the user presses the left mousebutton down on the Tray.
• xTrayOnLeftClickUp ACTION
  Sets an action to perform when the user releases the left mousebutton on the Tray.
• xTrayOnMiddleClickDown ACTION
  Sets an action to perform when the user presses the middle mousebutton down on the Tray.
• xTrayOnMiddleClickUp ACTION
  Sets an action to perform when the user releases the middle mousebutton on the Tray.
• xTrayOnRightClickDown ACTION
  Sets an action to perform when the user presses the right mousebutton down on the Tray.
• xTrayOnRightClickUp ACTION
  Sets an action to perform when the user releases the right mouse button on the Tray.
• xTrayOnWheelDown ACTION
  Sets an action to perform when the mouse wheel scrolls down while the mouse cursor hovers over the Tray.
  See also: xTrayFocusOnEnter
• xTrayOnWheelUp ACTION
  Sets an action to perform when the mouse wheel scrolls up while the mouse cursor hovers over the Tray.
  See also: xTrayFocusOnEnter
• xTrayOnResize ACTION
  Sets an action to perform when the Tray has changed its size.
• xTrayOnMove ACTION
  Sets an action to perform when the Tray has changed its position.
• xTrayOnAdd ACTION
  Sets an action to perform when a Trayicon has been added.
• xTrayOnRemove ACTION
  Sets an action to perform when a Trayicon has been removed.
• xTrayOnLineAdd ACTION
  Sets an action to perform when a line has been added.
• xTrayOnLineRemove ACTION
  Sets an action to perform when a line has been removed.

The following "WildcardString" references use the "Standard Wildcard" Syntax!
In the WildcardString:
'*' matches any sequence of characters (zero or more)
'?' matches any character
[SET] matches any character in the specified set,
[!SET] or [^SET] matches any character not in the specified set.

A set is composed of characters or ranges; a range looks like character hyphen character (as in 0-9 or A-Z). [0-9a-zA-Z_] is the minimal set of characters allowed in the [..] pattern construct. Other characters are allowed (ie. 8 bit characters) if your system will support them.

To suppress the special syntactic significance of any of '[]*?!^-\', and match the character exactly, precede it with a '\'.

You can remove the Buttons of specific Applications with the following:

*xTrayHide "SubString from Classname" ["SubString from Windowname"]

The "Classname" is required, the "Windowname" is optional!
Without a specified "Windowname", all Icons which match "Classname" will be hidden.
All Applications, which match the specifications, will not be shown in xTray.

Example:
*xTrayHide "*free*"
All Applications, which have the string "free" somewhere in their Classname, will be ignored from xTray.
You can Show(Hide) them with !xTrayToggleHiddenIcons!

You can deactivate the Manual Positioning of Icons of specific Applications with the following:

*xTrayNoDragnDrop "SubString from Classname" ["SubString from Windowname"]

The "Classname" is required, the "Windowname" is optional!
Without a specified "Windowname", all Icons which match "Classname" won't react on Drag'n'Drop.
All Applications, which match the specifications, will not react on manual repositioning.

You can sort Icons of specific Applications with the following:

*xTrayPosition INT "SubString from Classname" ["SubString from Windowname"]

The INT and "Classname" is required, the "Windowname" is optional!
You can set a fixed (unchangeable!) order of TrayIcons with these lines!
Starting with the lowest INT, all TrayIcons with a matching *xTrayPosition line are sorted ascending. All other TrayIcons are ordered, AFTER those with a *xTrayPosition line, the same way as before, in order of creation or a later drag'n'drop positioning.
Without a specified "Windowname", all Icons which match "Classname" won't react on Drag'n'Drop.

To obtain the correct values for Classname and Windowname, perform a MiddleClick on an Icon while pressing SHIFT key!

Main Layout Examples

Normal AutoSizing Singleline xTray in the bottomright of the screen growing to the left. Sends a Command to resize an aligned Taskbar!
xTrayX -0
xTrayY -24
xTrayBorders 4
xTrayAutoSize
xTraySolidColors c0c0c0 000000
xTraySolidBevelSize 1
xTrayDirection .left
xTrayOnResize !parseevars !xTaskbarResize %#resolutionx-xtraycurrentwidth$# %#xtaskbarcurrentheight%#

The same as above without a BG and without Pink IconBorders under XP
xTrayX -0
xTrayY -24
xTrayBorders 4
xTrayAutoSize
IF WINXP
xTrayAlphaMap
xTrayImage transparent.png (a fully Transparent AlphaMap Image!)
ENDIF
xTrayDirection .left
xTrayOnResize !parseevars !xTaskbarResize %#resolutionx-xtraycurrentwidth%# %#xtaskbarcurrentheight%#

Two Lines, vertically filled (top->bottom) with automatically added and removed lines (growing to the left)!
xTrayX -0
xTrayY -40
xTrayAutoSize
xTrayLayout .vertical
xTrayDirection .bottom
xTrayWrapDirection .left
xTrayLines 2
xTrayWrapCount 2
xTraySolidColors c0c0c0 000000
xTraySolidBevelSize 1


No AutoSizing, Two Lines, horizontally filled (left->right) a WrapCount of 3 to the bottom, with automatically added space when more then 6 icons occur (growing to the left)!
xTrayX -56
xTrayY -40
xTrayWidth 56
xTrayHeight 40
xTrayBorders 4
xTrayDirection .left
xTrayLines 2
xTrayWrapCount 3
xTraySolidColors c0c0c0 000000
xTraySolidBevelSize 1
xTrayOnLineAdd !parseevars !execute [!xtrayrepositionby -16 0 16 0][!xTrayRefresh xTrayWrapCount %#xTraywrapcount+1%#]

An so on, i hope you got a little impression. It's basically the same as in xTaskbar, if you can setup xTaskbar, you can easily setup xTray :)

Tips'n'Tricks

You miss the popping up Tray InfoTips from Win2000/XP!

Simply set xTrayShowInfoTip and be happy. Not all features, such as clickable Links in SP2, work, but at least you get the Info!
Attention:
Due to a "missing line" in 0.24.7-RC3 as well as in my xStep-0.24.7 (based on RC3) there is no InfoTip Icon Info sent, therefore i have released a Bugfix xStep Version (0.24.7.1)!
So, if somebody want a more complete feature, update your LS Build with xStep-0.24.7.1 :)

You want an Icon-Only Tray, and all the other Tray Modules gave you Pink Outlines under WinXP!

Case 1:
The xTray is directly on the Desktop (not hooked or AlwaysOnTop)!
It works from alone, cause you have FakeTransparency by Default activated :)
Icons Look Perfect!

Case 2:
The xTray is hooked!
First, you should set xTrayTransparencyMode just to be sure ;)
Without any problem it works now, BUT, the AlphaChannel is simply removed, so some icons will look less good!
AlphaChannel Icons Look Poorer!

Case 3:
The xTray isn't hooked, but AlwaysOnTop!
You must set xTrayAlphaMap AND use a fully transparent Image (100% Transparency) as xTrayImage!!
Icons Look Perfect!
In this case works also the poorer looking solution mentioned in Case 2!

You can reposition the TrayIcons per Drag'n'Drop!

Simply Press the Left Button Down on an Icon and while pressing the Button further Move over another Icon and release the Button.

You can "Hide TrayIcons" automatically or manually!

Either use *xTrayHide "SubString from Classname" ["SubString from Windowname"] or perform a MiddleClick on an Icon while pressing CTRL Key!
In both cases the matching Icon will be hidden from the Tray!
You can Toggle them on again with the Bang !xTrayToggleHiddenIcons (then use the CTRL+MiddleClick to reshow them permanently).
Those icons with the "Hidden" Flag have an Info in the Tooltip, so that you can identify them.

You can move the Tray with the Border and LeftButton!

Simply enable it via xTrayMoveable, make sure you have a Border and you don't have set a LeftClick Tray Action!

You can Scroll through the Icons, in an endless Loop, with the MouseWheel or MiddleClick (not in AutoSize Mode!)

You have also the Bang !xTrayScrollIcons "next" or "prev" [AMOUNT] for that. The optional AMOUNT, specifies how many Icons will be scrolled. If the AMOUNT reaches/exceeds the first or last Icon, the current Scroll will stop there.

You can obtain the neccessary Hiding Informations for "*xTrayHide", "*xTrayNoDragnDrop" or *xTrayPosition automatically!

To obtain the correct values for hiding, perform a MiddleClick on an Icon while pressing SHIFT key!

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

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