The icon control is used to display
graphics within bars, which can optionally be bound to properties of other controls to
construct buttons. Additionally, the icon control can be used without graphics to affect
the positioning of other controls within its bar by creating extra space.
Using the default values for all attributes will simply
produce extra space between adjacent controls, equal to the
attribute of the parent
bar tag. The
height if the parent bar is aligned left of right) can be define to
increase the amount of space.
To display arbitrary graphics in a bar, just supply its URL for the
attribute. By default, the control will resize the graphic proportionately to fit the space
implied by the parent bar's
padding attributes, but you can
override this behavior by specifying
There are two other attributes that specify graphics associated with buttons -
disicon. The first is used when the mouse is over the
control or its
select attribute evaluates to true. The second is used when the
disable attribute evaluates to true.
For the control to actually do something when clicked, its
bind attribute must be
specified. If the property supplied is more than a simple trigger like 'timeline.delete', the
value attribute will probably also need to be defined. For instance, both a play and
pause button would be bound to 'player.play' but with
value attributes of '1' and '0'
respectively. These values might also be used in the
hide attribute condition, so each button is
only displayed when its action is appropriate.
align: the string 'top', 'left' or 'center'
angle: floating point number (degrees)
bind: an object ID, period and property name
border: positive integer (pixels)
bordercolor: six character hex color value
color: six character hex color value
disicon: valid URL to a graphic
disable: an object ID, period and property name followed by a condition and value
grad: floating point number less than 128
hide: an object ID, period and property name followed by a condition and value
height: integer (pixels) or '*', '**'... (proportional)
icon: valid URL to a graphic
overicon: valid URL to a graphic
select: an object ID, period and property name followed by a condition and value
symbol: a valid SWF URL, followed by an ampersand and class name
width: integer (pixels) or '*', '**'... (proportional)