Icons.XML File Documentation

Description

The icons.xml file indicates which icons a user would like to place on their dock. The file is in XML format, and has a root Icons node. Each node under the Icons node will indicate some kind of icon on the dock.

Shortcut

A shortcut icon launches a program. It is indicated the type attribute being set to Bauble.Buttons.Shortcut and has the following properties:

Image - The (fully qualified, or application-relative) path to an image to use as an icon. An image may be a BMP, GIF, JPG or PNG. Typically a PNG will be used for full color with alpha transparency.
Text - A short description indicating the name of the program.
Executable - The fully qualified path to an executable to launch. This path may utilize environment variables.
WorkingDirectory - The fully qualified path the executable will launch in. This path may utilize environment variables. This is not necessarily the directory that the executable is in.
Arguments - Command line parameters to pass to the launching application.

Example

  <Icon type="Bauble.Buttons.Shortcut">
    <Image>icons/Notepad.png</Image>
    <Text>Notepad</Text>
    <Executable>%windir%\system32\notepad.exe</Executable>
    <WorkingDirectory>%HOMEDRIVE%%HOMEPATH%</WorkingDirectory>
    <Arguments></Arguments>
  </Icon>

Clock

A clock icon shows an analog clock on the dock that is updated in real time. It is indicated the type attribute being set to Bauble.Buttons.Clock and has the following properties:

Text - A short description of the clock. Future versions may support an offset or timezone, in which case this text could be set to the name of the timezone being displayed.

Example

<Icon type="Bauble.Buttons.Clock">
    <Text>Clock</Text>
</Icon>

Separator

An icon that adds separation space allowing visual grouping. It is indicated the type attribute being set to Bauble.Buttons.Clock and has no properties.

Example

<Icon type="Bauble.Buttons.Separator"/>

Last edited Jul 10, 2012 at 2:06 PM by cyberknet, version 6

Comments

No comments yet.