SetEventHandler

包	mx.states
类	public class SetEventHandler
继承	SetEventHandler OverrideBase OnDemandEventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

MXML 语法

隐藏 MXML 语法

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

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

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		handlerFunction : Function 事件的处理函数。	SetEventHandler
		name : String 要设置其处理函数的事件的名称。	SetEventHandler
		originalHandlerFunction : Function 应用覆盖之前要删除的处理函数。	SetEventHandler
		target : Object 调度事件的组件。	SetEventHandler

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		SetEventHandler(target:EventDispatcher = null, name:String = null) 构造函数。	SetEventHandler
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	OnDemandEventDispatcher
		apply(parent:UIComponent):void [覆盖] 应用覆盖。	SetEventHandler
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	OnDemandEventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialize():void IOverride 接口方法；该类将其作为空方法实现。	OverrideBase
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		remove(parent:UIComponent):void [覆盖] 删除覆盖。	SetEventHandler
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	OnDemandEventDispatcher

事件

单击此处了解有关事件的更多信息

	事件		摘要	由以下参数定义
		handler	为响应由 name 属性指定的事件而执行的事件处理函数。	SetEventHandler

属性详细信息

handlerFunction

属性

public var handlerFunction:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 null。

name

属性

public var name:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

originalHandlerFunction

属性

public var originalHandlerFunction:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 9, AIR 1.1

应用覆盖之前要删除的处理函数。

默认值为 null。

target

属性

public var target:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 null。

构造函数详细信息

()

构造函数

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

参数

	`target:EventDispatcher` (default = `null`) — 调度要处理的事件的对象。默认情况下，Flex 使用 State 对象的直接父级。

	`name:String` (default = `null`) — 要设置处理函数的事件类型。

方法详细信息

apply

()

方法

override public function apply(parent:UIComponent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

参数

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

remove

()

方法

override public function remove(parent:UIComponent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

参数

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

事件详细信息

handler

事件

事件对象类型: Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

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

法律声明 | 在线隐私策略

SetEventHandler - AS3 Flex

类 x

handlerFunction

name

originalHandlerFunction

target