ComponentEvent

包	fl.events
类	public class ComponentEvent
继承	ComponentEvent Event Object

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

ComponentEvent 类定义与 UIComponent 类关联的事件。这些事件包括下列事件：

ComponentEvent.BUTTON_DOWN：在按下按钮以后调度。
ComponentEvent.ENTER：在按下 Enter 键以后调度。
ComponentEvent.HIDE：在组件的 visible 属性设置为 false 以后调度。
ComponentEvent.LABEL_CHANGE：在按下 Enter 键以后调度。
ComponentEvent.MOVE：在更改标识组件位置的 x 或 y 属性以后调度。
ComponentEvent.RESIZE：在调整组件大小以后调度。
ComponentEvent.SHOW：在组件的 visible 属性设置为 true 以后调度。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) 创建包含有关组件事件信息的新 ComponentEvent 对象。	ComponentEvent
		clone():Event [覆盖] 创建 ComponentEvent 对象的副本，并设置每个参数的值以匹配原始参数值。	ComponentEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回一个字符串，其中包含 ComponentEvent 对象的所有属性。	ComponentEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		BUTTON_DOWN : String = "buttonDown" [静态] 定义 buttonDown 事件对象的 type 属性值。	ComponentEvent
		ENTER : String = "enter" [静态] 定义 enter 事件对象的 type 属性值。	ComponentEvent
		HIDE : String = "hide" [静态] 定义 hide 事件对象的 type 属性值。	ComponentEvent
		LABEL_CHANGE : String = "labelChange" [静态] 定义 labelChange 事件对象的 type 属性值。	ComponentEvent
		MOVE : String = "move" [静态] 定义 move 事件对象的 type 属性值。	ComponentEvent
		RESIZE : String = "resize" [静态] 定义 resize 事件对象的 type 属性值。	ComponentEvent
		SHOW : String = "show" [静态] 定义 show 事件对象的 type 属性值。	ComponentEvent

构造函数详细信息

()

构造函数

public function ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false)

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

创建包含有关组件事件信息的新 ComponentEvent 对象。ComponentEvent 对象作为参数传递到事件侦听器。

参数

	`type:String` — 事件的类型。事件侦听器可以通过事件对象的 `type` 属性来访问此信息。组件可以具有以下事件类型：`ComponentEvent.BUTTON_DOWN`、`ComponentEvent.ENTER`、`ComponentEvent.HIDE`、`ComponentEvent.LABEL_CHANGE`、`ComponentEvent.MOVE`、`ComponentEvent.RESIZE` 和 `ComponentEvent.SHOW`。

	`bubbles:Boolean` (default = `false`) — 确定 ComponentEvent 对象是否参与事件流的 Bubbling 阶段。事件侦听器可以通过事件对象的 `bubbles` 属性来访问此信息。

	`cancelable:Boolean` (default = `false`) — 确定是否可以取消 ComponentEvent 对象。事件侦听器可以通过事件对象的 `cancelable` 属性来访问此信息。

方法详细信息

clone

()

方法

override public function clone():Event

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

创建 ComponentEvent 对象的副本，并设置每个参数的值以匹配原始参数值。

Event — 其属性值与原始属性值匹配的新 ComponentEvent 对象。

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

返回一个字符串，其中包含 ComponentEvent 对象的所有属性。字符串的格式如下：

[ComponentEvent type=value bubbles=value cancelable=value]

String — ComponentEvent 对象的字符串表示形式。

常量详细信息

BUTTON_DOWN

常量

public static const BUTTON_DOWN:String = "buttonDown"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 buttonDown 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

ENTER

常量

public static const ENTER:String = "enter"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 enter 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

HIDE

常量

public static const HIDE:String = "hide"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 hide 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

LABEL_CHANGE

常量

public static const LABEL_CHANGE:String = "labelChange"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 labelChange 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

MOVE

常量

public static const MOVE:String = "move"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 move 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

示例 ( 如何使用本示例 )

下例根据 Slider 组件的值在舞台上重新定位 UILoader 组件实例：


import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.ComponentEvent;
import fl.events.SliderEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 20); 
myUILoader.addEventListener(ComponentEvent.MOVE, moveHandler);
addChild(myUILoader);

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.minimum = myUILoader.x;
mySlider.maximum = myUILoader.x + 200;
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myUILoader.x = event.value;
}

function moveHandler(event:ComponentEvent):void {
    trace("[move] x:" + event.currentTarget.x + ", y:" + event.currentTarget.y);
}

RESIZE

常量

public static const RESIZE:String = "resize"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 resize 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

示例 ( 如何使用本示例 )

下例将外部图像加载到 UILoader 组件实例中，并使用 resize 事件和 move() 方法将该图像居中放置在舞台上：


import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var myImg:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - myImg.width) / 2;
    var newY:uint = (stage.stageHeight - myImg.height) / 2;
    myImg.move(newX, newY);
}

SHOW

常量

public static const SHOW:String = "show"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 show 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

ComponentEvent - AS3 Flash

类 x

ComponentEvent

clone

toString

BUTTON_DOWN

ENTER

HIDE

LABEL_CHANGE

MOVE

RESIZE

SHOW