创建一个 TouchEvent 对象,其中包含有关Touch事件的信息
事件的类型,可以作为 Event.type 访问。
Optionalbubbles: boolean
确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。
Optionalcancelable: boolean
确定是否可以取消 Event 对象。默认值为 false。
OptionalstageX: number
事件发生点在全局舞台坐标系中的水平坐标
OptionalstageY: number
事件发生点在全局舞台坐标系中的垂直坐标
OptionaltouchPointID: number
分配给触摸点的唯一标识号
StaticADDED_在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。
StaticREMOVED_在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。
StaticADDED将显示对象添加到显示列表中时调度。
StaticREMOVED将要从显示列表中删除显示对象时调度。
StaticENTER_[广播事件] 进入新的一帧,监听此事件将会在下一帧开始时触发一次回调。这是一个广播事件,可以在任何一个显示对象上监听,无论它是否在显示列表中。
StaticRENDER渲染事件,监听此事件将会在本帧末即将开始渲染的前一刻触发回调,这是一个广播事件,可以在任何一个显示对象上监听,无论它是否在显示列表中。 注意:每次您希望 Egret 发送 Event.RENDER 事件时,都必须调用 stage.invalidate() 方法,由于每帧只会触发一次屏幕刷新, 若在 Event.RENDER 回调函数执行期间再次调用stage.invalidate(),将会被忽略。
StaticRESIZE舞台尺寸或UI组件尺寸发生改变
StaticCHANGE属性值或状态发生改变。通常是按钮的选中状态,或者列表的选中项索引改变。
StaticCHANGING属性值或状态即将发生改变,通常是按钮的选中状态,或者列表的选中项索引改变。可以通过调用 preventDefault() 方法阻止索引发生更改。
StaticCOMPLETE网络请求加载完成
StaticLOOP_循环完成。循环最后一次只派发 COMPLETE 事件,不派发 LOOP_COMPLETE 事件。
StaticFOCUS_TextInput实例获得焦点
StaticFOCUS_TextInput实例失去焦点
StaticENDED动画声音等播放完成
StaticACTIVATE游戏激活
StaticDEACTIVATE取消激活
StaticCLOSEEvent.CLOSE 常量定义 close 事件对象的 type 属性的值。
StaticCONNECTEvent.CONNECT 常量定义 connect 事件对象的 type 属性的值。
StaticLEAVE_Event.LEAVE_STAGE 常量定义 leaveStage 事件对象的 type 属性的值。
StaticSOUND_Event.SOUND_COMPLETE 常量定义 在声音完成播放后调度。
与此事件对象关联的可选数据。
StaticTOUCH_当用户触碰设备时进行调度,而且会连续调度,直到接触点被删除。
StaticTOUCH_当用户第一次触摸启用触摸的设备时(例如,用手指触摸配有触摸屏的移动电话或平板电脑)调度。
StaticTOUCH_当用户移除与启用触摸的设备的接触时(例如,将手指从配有触摸屏的移动电话或平板电脑上抬起)调度。
StaticTOUCH_由于某个事件取消了触摸时触发。比如 Scroller 在开始滚动后会触发 'TOUCH_CANCEL' 事件,不再触发后续的 'TOUCH_END' 和 'TOUCH_TAP' 事件
StaticTOUCH_当用户在触摸设备上与开始触摸的同一 DisplayObject 实例上抬起接触点时调度。
StaticTOUCH_当用户在触摸设备上与开始触摸的不同 DisplayObject 实例上抬起接触点时调度。
分配给触摸点的唯一标识号
表示触摸已按下 (true) 还是未按下 (false)。
如果可以取消事件的默认行为,则取消该行为。 许多事件都有默认执行的关联行为。例如,如果用户在文本字段中键入一个字符,则默认行为就是在文本字段中显示该字符。 由于可以取消 TextEvent.TEXT_INPUT 事件的默认行为,因此您可以使用 preventDefault() 方法来防止显示该字符。 您可以使用 Event.cancelable 属性来检查是否可以防止与特定事件关联的默认行为。如果 Event.cancelable 的值为 true, 则可以使用 preventDefault() 来取消事件;否则,preventDefault() 无效。
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。此方法不会影响当前节点 currentTarget 中的任何事件侦听器。
相比之下,stopImmediatePropagation() 方法可以防止对当前节点中和后续节点中的事件侦听器进行处理。
对此方法的其它调用没有任何效果。可以在事件流的任何阶段中调用此方法。
注意:此方法不会取消与此事件相关联的行为;有关此功能的信息,请参阅 preventDefault()。
ProtectedcleanStaticdispatch使用指定的 EventDispatcher 对象来抛出 Event 事件对象。抛出的对象将会缓存在对象池上,供下次循环复用。
{IEventDispatcher} 派发事件目标
{string} 事件类型
{boolean} 确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。
Optionaldata: any
{any} 事件data
StaticcreateStaticrelease释放一个事件对象,并缓存到对象池。我们建议您尽可能使用Event.create()和Event.release() 这一对方法来创建和释放事件对象,
这一对方法会将事件实例在内部缓存下来供下次循环使用,减少对象的创建次数,从而获得更高的代码运行性能。
注意:此方法只能传入由Event.create()创建的事件实例,传入非法对象实例可能会导致报错。
Staticdispatch使用指定的EventDispatcher对象来抛出Event事件对象。抛出的对象将会缓存在对象池上,供下次循环复用。
派发事件目标
事件的类型,可以作为 Event.type 访问。
Optionalbubbles: boolean
确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。
Optionalcancelable: boolean
确定是否可以取消 Event 对象。默认值为 false。
OptionalstageX: number
事件发生点在全局舞台坐标系中的水平坐标
OptionalstageY: number
事件发生点在全局舞台坐标系中的垂直坐标
OptionaltouchPointID: number
分配给触摸点的唯一标识号
使用 TouchEvent 类,您可以处理设备上那些检测用户与设备之间的接触的事件。 当用户与带有触摸屏的移动电话或平板电脑等设备交互时,用户通常使用手指或指针设备接触屏幕。可使用 TouchEvent 类开发响应基本触摸事件(如单个手指点击)的应用程序。使用此类中定义的事件类型创建事件侦听器。 注意:当对象嵌套在显示列表中时,触摸事件的目标将是显示列表中可见的最深的可能嵌套对象。 此对象称为目标节点。要使目标节点的祖代(祖代是一个包含显示列表中所有目标节点的对象,从舞台到目标节点的父节点均包括在内) 接收触摸事件的通知,请对祖代节点使用 EventDispatcher.on() 并将 type 参数设置为要检测的特定触摸事件。
Version
Egret 2.4
Platform
Web
Include Example
egret/events/TouchEvent.ts
Language
zh_CN