mx.states
public class SetEventHandler
继承SetEventHandler Inheritance EventDispatcher Inheritance Object
实现 IOverride

SetEventHandler 类指定只在特定视图状态期间才处于活动状态的事件处理函数。例如,可以定义一个在基本视图状态中使用一个事件处理函数而当更换视图状态时使用另一个事件处理函数的 Button 控件。

可以在 State 类的 overrides 属性中使用该类。

MXML 语法expanded隐藏 MXML 语法

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

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

另请参见

mx.states.State
mx.states.SetProperty
mx.states.SetStyle


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  handlerFunction : Function
事件的处理函数。
SetEventHandler
  name : String
要设置其处理函数的事件的名称。
SetEventHandler
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  target : EventDispatcher
调度事件的组件。
SetEventHandler
公共方法
 方法定义方
  
SetEventHandler(target:EventDispatcher = null, name:String = null)
构造函数。
SetEventHandler
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
  
应用覆盖。
SetEventHandler
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
  
初始化覆盖。
SetEventHandler
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
  
删除覆盖。
SetEventHandler
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
  为响应由 name 属性指定的事件而执行的事件处理函数。SetEventHandler
属性详细信息
handlerFunction属性
public var handlerFunction:Function

事件的处理函数。此属性面向使用 ActionScript 创建和访问视图状态的开发人员。在 MXML 中,可以使用等效的 handler event 属性;不要在一个 MXML 标签中同时使用二者。

默认值为 null.

name属性 
public var name:String

要设置其处理函数的事件的名称。必须设置该属性,或在 SetEventHandler 构造函数中设置,或通过直接设置该属性值设置。

target属性 
public var target:EventDispatcher

调度事件的组件。如果属性值为 null,则 Flex 将使用 <mx:states> 标签的直接父级。

默认值为 null.

构造函数详细信息
SetEventHandler()构造函数
public function SetEventHandler(target:EventDispatcher = null, name:String = null)

构造函数。

参数
target:EventDispatcher (default = null) — 调度要处理的事件的对象。默认情况下,Flex 使用 State 对象的直接父级。
 
name:String (default = null) — 要设置处理函数的事件类型。
方法详细信息
apply()方法
public function apply(parent:UIComponent):void

应用覆盖。Flex 将保留原始值,以便以后可以在 remove() 方法中恢复该值。

当进入状态时自动调用此方法。不应直接对其进行调用。

参数

parent:UIComponent — 包含此覆盖的状态对象的父级。如果未指定明确目标,覆盖应使用它作为其目标。

initialize()方法 
public function initialize():void

初始化覆盖。Flex 在第一次调用 apply() 方法之前调用此方法,因此将覆盖的一次性初始化代码放在此方法中。

当进入状态时,Flex 自动调用此方法。不应直接对其进行调用。

IOverride 接口方法;该类将其作为空方法实现。

remove()方法 
public function remove(parent:UIComponent):void

删除覆盖。在 apply() 方法中记住的值将被恢复。

当进入状态时自动调用此方法。不应直接对其进行调用。

参数

parent:UIComponent — 包含此覆盖的状态对象的父级。如果未指定明确目标,覆盖应使用它作为其目标。

事件详细信息
handler 事件
事件对象类型: Object
属性 .type = eventType

为响应由 name 属性指定的事件而执行的事件处理函数。

请勿在一个 <mx:SetEventHandler> 标签中指定 handler 属性和 handlerFunction 属性。

Flex 调度 handler 事件。handler 关键字只能用作 MXML 属性。在使用 handler handler 属性时,可以指定使用多个参数(而不仅是 Event 对象)的方法,还可以在 MXML 标签中指定处理函数代码。