ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
fl.events 

SliderEvent  - AS3 Flash

Packagefl.events
Classpublic class SliderEvent
InheritanceSliderEvent Inheritance Event Inheritance Object

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

The SliderEvent class defines events that are associated with the Slider component. These include the following:
  • SliderEvent.CHANGE: dispatched after there is a change in the position of the slider.
  • SliderEvent.THUMB_DRAG: dispatched when a user drags the thumb of the slider.
  • SliderEvent.THUMB_PRESS: dispatched when a user presses the thumb of the slider.
  • SliderEvent.THUMB_RELEASE: dispatched when the user releases the thumb of the slider.

Related API Elements



Public Properties
 PropertyDefined By
 Inheritedbubbles : Boolean
[read-only] Indicates whether an event is a bubbling event.
Event
 Inheritedcancelable : Boolean
[read-only] Indicates whether the behavior associated with the event can be prevented.
Event
  clickTarget : String
[read-only] Gets a string that indicates whether the slider thumb or a slider track was pressed.
SliderEvent
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritedcurrentTarget : Object
[read-only] The object that is actively processing the Event object with an event listener.
Event
 InheritedeventPhase : uint
[read-only] The current phase in the event flow.
Event
  keyCode : Number
[read-only] Gets the key code for the key that was pressed to trigger the event.
SliderEvent
 Inheritedtarget : Object
[read-only] The event target.
Event
  triggerEvent : String
[read-only] Gets the type of device that was used to send the input.
SliderEvent
 Inheritedtype : String
[read-only] The type of event.
Event
  value : Number
[read-only] Gets the new value of the slider, based on its position.
SliderEvent
Public Methods
 MethodDefined By
  
SliderEvent(type:String, value:Number, clickTarget:String, triggerEvent:String, keyCode:int = 0)
Creates a new SliderEvent object with the specified parameters.
SliderEvent
  
[override] Creates a copy of the SliderEvent object and sets the value of each parameter to match the original.
SliderEvent
 Inherited
formatToString(className:String, ... arguments):String
A utility function for implementing the toString() method in custom ActionScript 3.0 Event classes.
Event
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Checks whether the preventDefault() method has been called on the event.
Event
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Cancels an event's default behavior if that behavior can be canceled.
Event
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Prevents processing of any event listeners in the current node and any subsequent nodes in the event flow.
Event
 Inherited
Prevents processing of any event listeners in nodes subsequent to the current node in the event flow.
Event
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
  
[override] Returns a string that contains all the properties of the SliderEvent object.
SliderEvent
 Inherited
Returns the primitive value of the specified object.
Object
Public Constants
 ConstantDefined By
  CHANGE : String = "change"
[static] Defines the value of the type property of a change event object.
SliderEvent
  THUMB_DRAG : String = "thumbDrag"
[static] Defines the value of the type property of a thumbDrag event object.
SliderEvent
  THUMB_PRESS : String = "thumbPress"
[static] Defines the value of the type property of a thumbPress event object.
SliderEvent
  THUMB_RELEASE : String = "thumbRelease"
[static] Defines the value of the type property of a thumbRelease event object.
SliderEvent
Property Detail

clickTarget

property
clickTarget:String  [read-only]

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Gets a string that indicates whether the slider thumb or a slider track was pressed. A value of SliderEventClickTarget.THUMB indicates that the slider thumb was pressed; a value of SliderEventClickTarget.TRACK indicates that the slider track was pressed.



Implementation
    public function get clickTarget():String

Related API Elements

keyCode

property 
keyCode:Number  [read-only]

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Gets the key code for the key that was pressed to trigger the event. A key code is a numeric value that identifies the key that was pressed.



Implementation
    public function get keyCode():Number

Related API Elements

triggerEvent

property 
triggerEvent:String  [read-only]

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Gets the type of device that was used to send the input. A value of InteractionInputType.MOUSE indicates that a mouse was the source of the input; a value of InteractionInputType.KEYBOARD indicates that a keyboard was the source of the input.



Implementation
    public function get triggerEvent():String

Related API Elements

value

property 
value:Number  [read-only]

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Gets the new value of the slider, based on its position.



Implementation
    public function get value():Number
Constructor Detail

SliderEvent

()Constructor
public function SliderEvent(type:String, value:Number, clickTarget:String, triggerEvent:String, keyCode:int = 0)

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Creates a new SliderEvent object with the specified parameters.

Parameters
type:String — The event type; this value identifies the action that triggered the event.
 
value:Number — The new value of the slider.
 
clickTarget:String — Indicates whether a slider thumb or the slider track was pressed. A value of SliderEventClickTarget.THUMB indicates that the slider thumb was pressed; a value of SliderEventClickTarget.TRACK indicates that the slider track was pressed.
 
triggerEvent:String — A String that indicates the source of the input. A value of InteractionInputType.MOUSE indicates that the mouse was the source of input; a value of InteractionInputType.KEYBOARD indicates that the keyboard was the source of input.
 
keyCode:int (default = 0) — If the event was triggered by a key press, this value is the key code that identifies that key.
Method Detail

clone

()method
override public function clone():Event

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Creates a copy of the SliderEvent object and sets the value of each parameter to match the original.

Returns
Event — A copy of the current SliderEvent instance.

toString

()method 
override public function toString():String

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Returns a string that contains all the properties of the SliderEvent object. The string is in the following format:

[SliderEvent type=value value=value bubbles=value cancelable=value keycode=value triggerEvent=value clickTarget=value]

Returns
String — A string representation of the SliderEvent object.
Constant Detail

CHANGE

Constant
public static const CHANGE:String = "change"

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Defines the value of the type property of a change event object.

This event has the following properties:

PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
clickTargetIdentifies whether the slider track or a slider thumb was pressed.
currentTargetThe object that is actively processing the event object with an event listener.
keyCodeIf the event was triggered by a key press, the code for the key that was pressed.
targetThe object that dispatched the event. The target is not always the object listening for the event. Use the currentTarget property to access the object that is listening for the event.
triggerEventThe type of device that triggered the event. A value of InteractionInputType.MOUSE indicates that a mouse was the source of input; a value of InteractionInputType.KEYBOARD indicates that a keyboard was the source of input.
valueThe value of the slider after the event.

THUMB_DRAG

Constant 
public static const THUMB_DRAG:String = "thumbDrag"

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Defines the value of the type property of a thumbDrag event object.

This event has the following properties:

PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
clickTargetIdentifies whether the slider track or a slider thumb was pressed.
currentTargetThe object that is actively processing the event object with an event listener.
keyCodeIf the event was triggered by a key press, the code for the key that was pressed.
targetThe object that dispatched the event. The target is not always the object listening for the event. Use the currentTarget property to access the object that is listening for the event.
triggerEventThe type of device that triggered the event. A value of InteractionInputType.MOUSE indicates that a mouse was the source of the input; a value of InteractionInputType.KEYBOARD indicates that a keyboard was the source of the input.
valueThe value of the slider after the event.

Related API Elements

THUMB_PRESS

Constant 
public static const THUMB_PRESS:String = "thumbPress"

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Defines the value of the type property of a thumbPress event object.

This event has the following properties:

PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
clickTargetIdentifies whether the slider track or a slider thumb was pressed.
currentTargetThe object that is actively processing the event object with an event listener.
keyCodeIf the event was triggered by a key press, the code for the key that was pressed.
targetThe object that dispatched the event. The target is not always the object listening for the event. Use the currentTarget property to access the object that is listening for the event.
triggerEventThe type of device that triggered the event. A value of InteractionInputType.MOUSE indicates that a mouse was the source of the input; a value of InteractionInputType.KEYBOARD indicates that a keyboard was the source of the input.
valueThe value of the slider after the event.

Related API Elements

THUMB_RELEASE

Constant 
public static const THUMB_RELEASE:String = "thumbRelease"

Language Version: ActionScript 3.0
Product Version: Flash CS3
Runtime Versions: Flash Player 9.0.28.0, AIR 1.0

Defines the value of the type property of a thumbRelease event object.

This event has the following properties:

PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
clickTargetIdentifies whether the slider track or a slider thumb was pressed.
currentTargetThe object that is actively processing the event object with an event listener.
keyCodeIf the event was triggered by a key press, the code for the key that was pressed.
targetThe object that dispatched the event. The target is not always the object listening for the event. Use the currentTarget property to access the object that is listening for the event.
triggerEventThe type of device that triggered the event. A value of InteractionInputType.MOUSE indicates that a mouse was the source of the input; a value of InteractionInputType.KEYBOARD indicates that a keyboard was the source of the input.
valueThe value of the slider after the event.

Related API Elements