Frames 

 No Frames

Previous Element
Blur

Next Element
ButtonActions


Button

This defines a button symbol that can be placed on a movie stage. A button has a number of button layers which specify the bounds and symbols used in the button. Each layer is associated with one or more button states (over, down, release, hit). Actions can be associated with a button using the optional ButtonActions element. Sounds can be associated with button events using the optional ButtonSound element.

Attributes

id A unique name for the symbol within the movie.
TypeString
dragTarget Determines the behavior of the button in relation to mouse press events.
Values
no
Normal button behavior. The button will not react when the mouse enters the button hit area while pressed and no events will be generated. However if the mouse is subsequently released over the button a 'rollOver' event will be generated. When the button is pressed and the mouse is moved outside the hit area the button state changes to the 'over' state and the cursor does not change from a button cursor.
yes
Behaves like a drag target or sub-menu button. When the mouse enters the button hit area while pressed the button's state changes to the 'down' state and 'dragOver' button events are generated. If the mouse is release over the button then a 'release' event is generated otherwise 'dragOut' events are generated when mouse dragged out. When the button is pressed and the mouse is moved outside the button will reset itself to the 'up' state and the cursor will reset to the normal cursor. A 'dragOutside' event will be generated but no 'releaseOutside' button events will be generated if mouse is released.
Default Valueno
bounds Optional attribute specifying the bounding rectangle of the Button specified as 'bounds( minX, minY, maxX, maxY)'. This attribute can be produced on decompilation as a guide to the actual runtime bounds of the symbol but it is not referenced by the RVML compiler. This is useful for the timeline elements (Place, Alter, Replace) to specify new scaling attributes for the Button symbol.
Value Template bounds(Coord, Coord, Coord, Coord)
TypeFloat

Child Elements

Desc
Metadata
Layers
ButtonSound
ButtonActions

Parent Elements

Definitions

Examples

Button Example
Button DragTarget Example
Button Sound Example

Previous Element
Blur

Next Element
ButtonActions