Egret Engine R - v6.0.0
    Preparing search index...

    使用 TouchEvent 类,您可以处理设备上那些检测用户与设备之间的接触的事件。 当用户与带有触摸屏的移动电话或平板电脑等设备交互时,用户通常使用手指或指针设备接触屏幕。可使用 TouchEvent 类开发响应基本触摸事件(如单个手指点击)的应用程序。使用此类中定义的事件类型创建事件侦听器。 注意:当对象嵌套在显示列表中时,触摸事件的目标将是显示列表中可见的最深的可能嵌套对象。 此对象称为目标节点。要使目标节点的祖代(祖代是一个包含显示列表中所有目标节点的对象,从舞台到目标节点的父节点均包括在内) 接收触摸事件的通知,请对祖代节点使用 EventDispatcher.on() 并将 type 参数设置为要检测的特定触摸事件。

    Egret 2.4

    Web

    egret/events/TouchEvent.ts

    zh_CN

    Hierarchy (View Summary)

    Index
    • 创建一个 TouchEvent 对象,其中包含有关Touch事件的信息

      Parameters

      • type: string

        事件的类型,可以作为 Event.type 访问。

      • Optionalbubbles: boolean

        确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。

      • Optionalcancelable: boolean

        确定是否可以取消 Event 对象。默认值为 false。

      • OptionalstageX: number

        事件发生点在全局舞台坐标系中的水平坐标

      • OptionalstageY: number

        事件发生点在全局舞台坐标系中的垂直坐标

      • OptionaltouchPointID: number

        分配给触摸点的唯一标识号

      Returns TouchEvent

      Egret 2.4

      Web

      zh_CN

    ADDED_TO_STAGE: string = "addedToStage"

    在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。

    Egret 2.4

    Web

    zh_CN

    REMOVED_FROM_STAGE: string = "removedFromStage"

    在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。

    Egret 2.4

    Web

    zh_CN

    ADDED: string = "added"

    将显示对象添加到显示列表中时调度。

    Egret 2.4

    Web

    zh_CN

    REMOVED: string = "removed"

    将要从显示列表中删除显示对象时调度。

    Egret 2.4

    Web

    zh_CN

    ENTER_FRAME: string = "enterFrame"

    [广播事件] 进入新的一帧,监听此事件将会在下一帧开始时触发一次回调。这是一个广播事件,可以在任何一个显示对象上监听,无论它是否在显示列表中。

    Egret 2.4

    Web

    zh_CN

    RENDER: string = "render"

    渲染事件,监听此事件将会在本帧末即将开始渲染的前一刻触发回调,这是一个广播事件,可以在任何一个显示对象上监听,无论它是否在显示列表中。 注意:每次您希望 Egret 发送 Event.RENDER 事件时,都必须调用 stage.invalidate() 方法,由于每帧只会触发一次屏幕刷新, 若在 Event.RENDER 回调函数执行期间再次调用stage.invalidate(),将会被忽略。

    Egret 2.4

    Web

    zh_CN

    RESIZE: string = "resize"

    舞台尺寸或UI组件尺寸发生改变

    Egret 2.4

    Web

    zh_CN

    CHANGE: string = "change"

    属性值或状态发生改变。通常是按钮的选中状态,或者列表的选中项索引改变。

    Egret 2.4

    Web

    zh_CN

    CHANGING: string = "changing"

    属性值或状态即将发生改变,通常是按钮的选中状态,或者列表的选中项索引改变。可以通过调用 preventDefault() 方法阻止索引发生更改。

    Egret 2.4

    Web

    zh_CN

    COMPLETE: string = "complete"

    网络请求加载完成

    Egret 2.4

    Web

    zh_CN

    LOOP_COMPLETE: string = "loopComplete"

    循环完成。循环最后一次只派发 COMPLETE 事件,不派发 LOOP_COMPLETE 事件。

    Egret 2.4

    Web

    zh_CN

    FOCUS_IN: string = "focusIn"

    TextInput实例获得焦点

    Egret 2.4

    Web

    zh_CN

    FOCUS_OUT: string = "focusOut"

    TextInput实例失去焦点

    Egret 2.4

    Web

    zh_CN

    ENDED: string = "ended"

    动画声音等播放完成

    Egret 2.4

    Web

    zh_CN

    ACTIVATE: string = "activate"

    游戏激活

    Egret 2.4

    Web

    DEACTIVATE: string = "deactivate"

    取消激活

    Egret 2.4

    Web

    CLOSE: string = "close"

    Event.CLOSE 常量定义 close 事件对象的 type 属性的值。

    Egret 2.4

    Web

    CONNECT: string = "connect"

    Event.CONNECT 常量定义 connect 事件对象的 type 属性的值。

    Egret 2.4

    Web

    LEAVE_STAGE: string = "leaveStage"

    Event.LEAVE_STAGE 常量定义 leaveStage 事件对象的 type 属性的值。

    Egret 2.4

    Web

    SOUND_COMPLETE: string = "soundComplete"

    Event.SOUND_COMPLETE 常量定义 在声音完成播放后调度。

    Egret 2.4

    Web

    data: any

    与此事件对象关联的可选数据。

    Egret 2.4

    Web

    zh_CN

    TOUCH_MOVE: "touchMove"

    当用户触碰设备时进行调度,而且会连续调度,直到接触点被删除。

    Egret 2.4

    Web

    zh_CN

    TOUCH_BEGIN: "touchBegin"

    当用户第一次触摸启用触摸的设备时(例如,用手指触摸配有触摸屏的移动电话或平板电脑)调度。

    Egret 2.4

    Web

    zh_CN

    TOUCH_END: "touchEnd"

    当用户移除与启用触摸的设备的接触时(例如,将手指从配有触摸屏的移动电话或平板电脑上抬起)调度。

    Egret 2.4

    Web

    zh_CN

    TOUCH_CANCEL: "touchCancel"

    由于某个事件取消了触摸时触发。比如 Scroller 在开始滚动后会触发 'TOUCH_CANCEL' 事件,不再触发后续的 'TOUCH_END' 和 'TOUCH_TAP' 事件

    Egret 3.0.1

    Web

    zh_CN

    TOUCH_TAP: "touchTap"

    当用户在触摸设备上与开始触摸的同一 DisplayObject 实例上抬起接触点时调度。

    Egret 2.4

    Web

    zh_CN

    TOUCH_RELEASE_OUTSIDE: "touchReleaseOutside"

    当用户在触摸设备上与开始触摸的不同 DisplayObject 实例上抬起接触点时调度。

    Egret 2.4

    Web

    zh_CN

    touchPointID: number

    分配给触摸点的唯一标识号

    Egret 2.4

    Web

    zh_CN

    touchDown: boolean = false

    表示触摸已按下 (true) 还是未按下 (false)。

    Egret 2.4

    Web

    zh_CN

    • get type(): string

      事件的类型。类型区分大小写。

      Returns string

      Egret 2.4

      Web

      zh_CN

    • get bubbles(): boolean

      表示事件是否为冒泡事件。如果事件可以冒泡,则此值为 true;否则为 false。

      Returns boolean

      Egret 2.4

      Web

      zh_CN

    • get cancelable(): boolean

      表示是否可以阻止与事件相关联的行为。如果可以取消该行为,则此值为 true;否则为 false。

      Returns boolean

      #preventDefault()

      Egret 2.4

      Web

      zh_CN

    • get eventPhase(): number

      事件流中的当前阶段。此属性可以包含以下数值: 捕获阶段 (EventPhase.CAPTURING_PHASE)。 目标阶段 (EventPhase.AT_TARGET)。 冒泡阶段 (EventPhase.BUBBLING_PHASE)。

      Returns number

      EventPhase

      Egret 2.4

      Web

      zh_CN

    • get currentTarget(): any

      当前正在使用某个事件侦听器处理 Event 对象的对象。例如,如果用户单击“确定”按钮, 则当前目标可以是包含该按钮的节点,也可以是它的已为该事件注册了事件侦听器的始祖之一。

      Returns any

      Egret 2.4

      Web

      zh_CN

    • get target(): any

      事件目标。此属性包含目标节点。例如,如果用户单击“确定”按钮,则目标节点就是包含该按钮的显示列表节点。

      Returns any

      Egret 2.4

      Web

      zh_CN

    • get stageX(): number

      事件发生点在全局舞台坐标中的水平坐标。

      Returns number

      Egret 2.4

      Web

      zh_CN

    • get stageY(): number

      事件发生点在全局舞台坐标中的垂直坐标。

      Returns number

      Egret 2.4

      Web

      zh_CN

    • get localX(): number

      事件发生点相对于所属显示对象的水平坐标。

      Returns number

      Egret 2.4

      Web

      zh_CN

    • get localY(): number

      事件发生点相对于所属显示对象的垂直坐标。

      Returns number

      Egret 2.4

      Web

      zh_CN

    • get hashCode(): number

      返回此对象唯一的哈希值,用于唯一确定一个对象。hashCode为大于等于1的整数。

      Returns number

      Egret 2.4

      Web

      zh_CN

    • 检查是否已对事件调用 preventDefault() 方法。

      Returns boolean

      如果已调用 preventDefault() 方法,则返回 true;否则返回 false。

      #preventDefault()

      Egret 2.4

      Web

      zh_CN

    • 如果可以取消事件的默认行为,则取消该行为。 许多事件都有默认执行的关联行为。例如,如果用户在文本字段中键入一个字符,则默认行为就是在文本字段中显示该字符。 由于可以取消 TextEvent.TEXT_INPUT 事件的默认行为,因此您可以使用 preventDefault() 方法来防止显示该字符。 您可以使用 Event.cancelable 属性来检查是否可以防止与特定事件关联的默认行为。如果 Event.cancelable 的值为 true, 则可以使用 preventDefault() 来取消事件;否则,preventDefault() 无效。

      Returns void

      • #cancelable
      • #isDefaultPrevented

      Egret 2.4

      Web

      zh_CN

    • 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。此方法不会影响当前节点 currentTarget 中的任何事件侦听器。 相比之下,stopImmediatePropagation() 方法可以防止对当前节点中和后续节点中的事件侦听器进行处理。 对此方法的其它调用没有任何效果。可以在事件流的任何阶段中调用此方法。
      注意:此方法不会取消与此事件相关联的行为;有关此功能的信息,请参阅 preventDefault()。

      Returns void

      • #stopImmediatePropagation()
      • #preventDefault()

      Egret 2.4

      Web

      zh_CN

    • 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。此方法会立即生效,并且会影响当前节点中的事件侦听器。 相比之下,在当前节点中的所有事件侦听器都完成处理之前,stopPropagation() 方法不会生效。
      注意:此方法不会取消与此事件相关联的行为;有关此功能的信息,请参阅 preventDefault()。

      Returns void

      • #stopPropagation()
      • #preventDefault()

      Egret 2.4

      Web

      zh_CN

    • 当事件实例传递给Event.release()静态方法时,实例上的clean()方法将会被自动调用。 若此自定义事件的实例设计为可以循环复用的,为了避免引起内存泄露,自定义事件需要覆盖此方法来确保实例被缓存前断开对外部对象的一切引用。

      Returns void

      • egret.Event.create()
      • egret.Event.release()

      Egret 2.4

      Web

      zh_CN

    • 使用指定的 EventDispatcher 对象来抛出 Event 事件对象。抛出的对象将会缓存在对象池上,供下次循环复用。

      Parameters

      • target: IEventDispatcher

        {IEventDispatcher} 派发事件目标

      • type: string

        {string} 事件类型

      • bubbles: boolean = false

        {boolean} 确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。

      • Optionaldata: any

        {any} 事件data

      Returns boolean

      egret.Event.dispatchEvent

      Egret 2.4

      Web

      zh_CN

    • 从对象池中取出或创建一个新的事件实例。我们建议您尽可能使用Event.create()和Event.release() 这一对方法来创建和释放事件对象, 这一对方法会将事件实例在内部缓存下来供下次循环使用,减少对象的创建次数,从而获得更高的代码运行性能。
      注意:若使用此方法来创建自定义事件的实例,自定义的构造函数参数列表必须跟Event类一致。

      Type Parameters

      Parameters

      • EventClass: {
            eventPool?: Event[];
            new (type: string, bubbles?: boolean, cancelable?: boolean): T;
        }

        Event类名。

      • type: string

        事件的类型,可以作为 Event.type 访问。

      • Optionalbubbles: boolean

        确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。

      • Optionalcancelable: boolean

        确定是否可以取消 Event 对象。默认值为 false。

      Returns T

      <pre>
      let event = Event.create(Event,type, bubbles);
      event.data = data; //可选,若指定义事件上需要附加其他参数,可以在获取实例后在此处设置。
      this.dispatchEvent(event);
      Event.release(event);
      </pre>

      #clean()

      Egret 2.4

      Web

      zh_CN

    • 释放一个事件对象,并缓存到对象池。我们建议您尽可能使用Event.create()和Event.release() 这一对方法来创建和释放事件对象, 这一对方法会将事件实例在内部缓存下来供下次循环使用,减少对象的创建次数,从而获得更高的代码运行性能。
      注意:此方法只能传入由Event.create()创建的事件实例,传入非法对象实例可能会导致报错。

      Parameters

      Returns void

      <pre>
      let event = Event.create(Event,type, bubbles);
      event.data = data; //可选,若指定义事件上需要附加其他参数,可以在获取实例后在此处设置。
      this.dispatchEvent(event);
      Event.release(event);
      </pre>

      #clean()

      Egret 2.4

      Web

      zh_CN

    • 如果已修改显示列表,调用此方法将会忽略帧频限制,在此事件处理完成后立即重绘屏幕。

      Returns void

      Egret 2.4

      Web

      zh_CN

    • 使用指定的EventDispatcher对象来抛出Event事件对象。抛出的对象将会缓存在对象池上,供下次循环复用。

      Parameters

      • target: IEventDispatcher

        派发事件目标

      • type: string

        事件的类型,可以作为 Event.type 访问。

      • Optionalbubbles: boolean

        确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。

      • Optionalcancelable: boolean

        确定是否可以取消 Event 对象。默认值为 false。

      • OptionalstageX: number

        事件发生点在全局舞台坐标系中的水平坐标

      • OptionalstageY: number

        事件发生点在全局舞台坐标系中的垂直坐标

      • OptionaltouchPointID: number

        分配给触摸点的唯一标识号

      • touchDown: boolean = false

      Returns boolean

      • Event.create()
      • Event.release()

      Egret 2.4

      Web

      zh_CN