|
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 spacing
attribute of the parent bar tag. The width attribute
(or 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 icon
attribute. By default, the control will resize the graphic proportionately to fit the space
implied by the parent bar's size and padding attributes, but you can
override this behavior by specifying width and/or height attributes.
There are two other attributes that specify graphics associated with buttons -
overicon and 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
control's 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.
Attributes 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)
|