使用 dispatchEvent() 方法
在组件 ActionScript 类文件的正文中,您可以使用 dispatchEvent() 方法来广播事件。dispatchEvent() 方法的语法如下:
dispatchEvent(eventObj)
eventObj 参数是一个描述事件的 ActionScript 对象
在调用 dispatchEvent() 方法之前,必须在代码中对其进行声明,如下所示:
private var dispatchEvent:Function;
此外,还必须创建一个事件对象以传递给 dispatchEvent()。该事件对象包含侦听器可用来处理该事件的有关信息。
在发送事件之前可以显式地构建一个事件对象,如下面示例所示:
var eventObj = new Object();
eventObj.type = "myEvent";
eventObj.target = this;
dispatchEvent(eventObj);
您也可以使用快捷语法在一行代码中设置 type 属性和 target 属性的值,并发送事件:
ancestorSlide.dispatchEvent({type:"revealChild", target:this});
在上面的示例中,由于 target 属性是隐式的,因此,设置该属性是可选操作。
Flash 8 文档中对每个事件的说明列出了可选和必需的事件属性。例如,ScrollBar.scroll 事件除了使用 type 和 target 属性外,还使用 detail 属性。有关详细信息,请参阅"组件语言参考"中的事件说明。
下表列出了由各种类广播的公共事件。如果事件适用于组件,每个组件都应广播这些事件。这里没有列出所有组件的全部事件,只列出了可能会由其它组件重新使用的事件。虽然某些事件未指定任何参数,但所有事件都有隐式参数:对广播事件的对象的引用。
事件 | 使用 |
click | 由 Button 组件使用,或在鼠标单击没有其它含义时使用。 |
change | 由 List、ComboBox 和其它文本输入组件使用。 |
scroll | 由 ScrollBar 和其它导致滚动(在滚动弹出菜单上滚动"缓冲器")的控件使用。 |
此外,由于是从基类继承而来,所有组件都广播以下事件:
UIComponent 事件 | 说明 |
load | 组件正在创建或加载其子对象。 |
unload | 组件正在卸载其子对象。 |
focusIn | 组件现在有输入焦点。某些 HTML 等效组件(ListBox、ComboBox、Button、Text)还可以广播 focus,但所有组件都广播 DOMFocusIn。 |
focusOut | 组件已失去输入焦点。 |
move | 组件已被移至新位置。 |
resize | 组件大小已更改。 |
下表对一些常见的键事件进行说明:
键事件 | 说明 |
keyDown | 按下某个键。code 属性包含被按下键的键控代码,ascii 属性包含它的 ASCII 代码。不要使用低级 Key 对象检查,因为 Key 对象可能尚未生成该事件。 |
keyUp | 释放某个键。 |
as3.0 dispatchEvent()的用法
關於dispatchEvent()的用法困擾了我很長一段事間,總是摸不著它的用法。dispatchEvent用來自定一發送事件。今天特意在網上搜索了一些,把一些好的東西分享給大家。
關於自定義發送事件的3種方式大家可參照黑羽的博客http://www.kingda.org/archives/kingda/2006/08/as3095.html把他的教程讀讀,或許會有些明了。下面這些內容是摘自網絡上的一篇文章:
Evevt和EventDispatcher类在as3的事件机制中是很重要的角色,dispatchEvent()是EventDispatcher类 的一个事件发送方法,它可以发送出Event类或其子类的实例,在as3中所有的显示对象都可以发送事件,因为as3中所有的显示对象都是 EventDispatcher子类DisplayObject的实例。
发送事件有三种方式:继承EventDispatcher,如sprite等显示对象、复合EventDispatcher或其子类、实现IEventDispatcher接口。
个人认为复合EventDispatcher在实际应用中用的比较多,没有找到合适例子,自己写了一个很简单的,仅供参考,为了演示把简单的问题复杂话了,首先画一个矩形,点击矩形后发送一个事件,矩形接收事件后alpha变为0;
自定义事件:
package{
import flash.events.Event;
public class MyEvent extends Event{
public static const ALPHA:String = "alpha";
public function MyEvent(type:String, bubbles:Boolean=false, cancelable:Boolean=false){
super(type, bubbles, cancelable);
}
}
}
package{
import flash.display.Sprite;
public class Sample extends Sprite{
public function Sample(){
this.graphics.beginFill(0xff6600);
this.graphics.drawRect(50,50,100,50);
this.graphics.endFill();
this.addEventListener(MyEvent.ALPHA,blackHandler);
}
private function blackHandler(evt:MyEvent){
this.alpha = 0;
}
}
}
主类:
package{
import flash.display.Sprite;
import flash.events.MouseEvent;
public class Main extends Sprite{
private var sample:Sample;
public function Main(){
sample = new Sample();
//注册事件侦听器
sample.addEventListener(MouseEvent.CLICK,clickHandler);
addChild(sample);
}
private function clickHandler(evt:MouseEvent){
//发送事件
sample.dispatchEvent(new MyEvent(MyEvent.ALPHA));
}
}
}
注:在as3中只有事件的发送者才能侦听事件。在Main类中sample实例发送的事件也只有sample注册的侦听器才能侦听,在Sample中的this正是指向了sample。