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

    Class GeolocationEvent

    GeolocationEvent 提供设备的地理位置信息和获取位置时发生的错误信息

    Egret 2.4

    Web

    egret/sensor/Geolocation.ts

    http://edn.egret.com/cn/docs/page/662 获取位置信息

    zh_CN

    Hierarchy (View Summary)

    Index
    constructor
    ADDED_TO_STAGE REMOVED_FROM_STAGE ADDED REMOVED ENTER_FRAME RENDER RESIZE CHANGE CHANGING COMPLETE LOOP_COMPLETE FOCUS_IN FOCUS_OUT ENDED ACTIVATE DEACTIVATE CLOSE CONNECT LEAVE_STAGE SOUND_COMPLETE data PERMISSION_DENIED UNAVAILABLE longitude latitude speed heading altitude accuracy altitudeAccuracy errorType errorMessage
    type bubbles cancelable eventPhase currentTarget target hashCode
    $setTarget isDefaultPrevented preventDefault stopPropagation stopImmediatePropagation clean dispatchEvent create release

    • 创建一个作为参数传递给事件侦听器的 Event 对象。

      Parameters

      • type: string

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

      • Optionalbubbles: boolean

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

      • Optionalcancelable: boolean

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

      • Optionaldata: any

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

      Returns GeolocationEvent

      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

    PERMISSION_DENIED: string = "permissionDenied"

    由于用户拒绝访问位置信息，获取位置信息失败

    Egret 2.4

    Web

    zh_CN

    UNAVAILABLE: string = "unavailable"

    设备位置服务不可用或者超时等原因没有得到位置信息

    Egret 2.4

    Web

    zh_CN

    longitude: number

    当前位置的经度信息

    Egret 2.4

    Web

    zh_CN

    latitude: number

    当前位置的纬度信息

    Egret 2.4

    Web

    zh_CN

    speed: number

    当前设备的速度 单位是 米/秒，这个值可能为 null

    Egret 2.4

    Web

    zh_CN

    heading: number

    表示设备正在前进的方向，单位是度。heading 表示从正北开始顺时针旋转到当前方向的角度， 比如正东是 90 度，正西是 270 度，如果 speed 是 0，heading 为 NaN。

    Egret 2.4

    Web

    zh_CN

    altitude: number

    该位置的海拔信息，如果设备没有实现这个属性时，这个值有可能为 null

    Egret 2.4

    Web

    zh_CN

    accuracy: number

    经纬度的准确性，单位是米

    Egret 2.4

    Web

    zh_CN

    altitudeAccuracy: number

    该位置海拔信息的准确性，单位是米，这个值有可能为 null

    Egret 2.4

    Web

    zh_CN

    errorType: string

    获取位置信息错误时的错误类型。值可能为：

    • egret.GeolocationEvent.PERMISSION_DENIED
    • egret.GeolocationEvent.UNAVAILABLE

    Egret 2.4

    Web

    zh_CN

    errorMessage: string

    获取位置信息错误的错误信息

    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 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

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Accessors
    Methods