Adobe® Flex® 4 Language Reference
Hide Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
mx.states 
SetEventHandler 
Packagemx.states
Classpublic class SetEventHandler
InheritanceSetEventHandler Inheritance OverrideBase Inheritance OnDemandEventDispatcher Inheritance Object

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The SetEventHandler class specifies an event handler that is active only during a particular view state. For example, you might define a Button control that uses one event handler in the base view state, but uses a different event handler when you change view state.

You use this class in the overrides property of the State class.

MXML SyntaxexpandedHide MXML Syntax

The <mx:SetEventHanlder> tag has the following attributes:

  <mx:SetEventHandler
  Properties
  name="null"
  handlerFunction="null"
  target="null"
  
  Events
  handler=No default
  />
  

See also



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  handlerFunction : Function
The handler function for the event.
SetEventHandler
  name : String
The name of the event whose handler is being set.
SetEventHandler
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  target : Object
The component that dispatches the event.
SetEventHandler
Public Methods
 MethodDefined By
  
SetEventHandler(target:EventDispatcher = null, name:String = null)
Constructor.
SetEventHandler
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
OnDemandEventDispatcher
  
[override] Applies the override.
SetEventHandler
 Inherited
OnDemandEventDispatcher
 Inherited
OnDemandEventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Initializes the override.
OverrideBase
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
  
[override] Removes the override.
SetEventHandler
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
OnDemandEventDispatcher
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
OnDemandEventDispatcher
Events
 Event Summary Defined By
  The event handler function to execute in response to the event that is specified by the name property.SetEventHandler
Property Detail

handlerFunction

property
public var handlerFunction:Function

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The handler function for the event. This property is intended for developers who use ActionScript to create and access view states. In MXML, you can use the equivalent handler event attribute; do not use both in a single MXML tag.

The default value is null.

name

property 
public var name:String

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The name of the event whose handler is being set. You must set this property, either in the SetEventHandler constructor or by setting the property value directly.

target

property 
public var target:Object

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The component that dispatches the event. If the property value is null, Flex uses the immediate parent of the <mx:states> tag.

The default value is null.

Constructor Detail

SetEventHandler

()Constructor
public function SetEventHandler(target:EventDispatcher = null, name:String = null)

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Constructor.

Parameters
target:EventDispatcher (default = null) — The object that dispatches the event to be handled. By default, Flex uses the immediate parent of the State object.
 
name:String (default = null) — The event type for which to set the handler.
Method Detail

apply

()method
override public function apply(parent:UIComponent):void

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Applies the override. Flex retains the original value, so that it can restore the value later in the remove() method.

This method is called automatically when the state is entered. It should not be called directly.

Parameters

parent:UIComponent — The parent of the state object containing this override. The override should use this as its target if an explicit target was not specified.

remove

()method 
override public function remove(parent:UIComponent):void

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Removes the override. The value remembered in the apply() method is restored.

This method is called automatically when the state is entered. It should not be called directly.

Parameters

parent:UIComponent — The parent of the state object containing this override. The override should use this as its target if an explicit target was not specified.

Event Detail

handler

Event
Event Object Type: Object

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The event handler function to execute in response to the event that is specified by the name property.

Do not specify the handler property and the handlerFunction property in a single <mx:SetEventHandler> tag.

Flex does not dispatch a handler event. You use the handler key word only as an MXML attribte. When you use the handler handler attribute, you can specify a method that takes multiple parameters, not just the Event object; also, you can specify the handler code in-line in the MXML tag.