Button And ToggleButton

Button

Button is a control that reacts to a mouse/tap gesture. The Button:tap property is a Signal to which you can add a handler for the mouse/tap gesture.

Usage:

var button:Button = new Button();
button.label = "click me!";
// Assign signal handler.
button.tap.add( handleButtonTap );
addChild( button );
...
protected function handleButtonTap( evt:GenericEvent ):void
{
trace( "button tapped! " + evt.target );
}

ToggleButton

ToggleButton extends Button to provide a toggled state of selection. Alternatively, it manages the mouse/tap gesture internally to update the current state and notifies any clients that register to its toggle Signal.

Usage:

var toggleButton:ToggleButton = new ToggleButton();
toggleButton.label = "toggle me";
toggleButton.selected = false;
// Add signal hanlder
toggleButton.toggle.add( handleToggle );
addChild( toggleButton );
...
protected function handleToggle( evt:GenericEvent ):void
{
var toggle:ToggleButton = evt.target as ToggleButton;
trace( "toggled: " + toggle.selected  );
}