Class: PointerInteraction

ol/interaction/Pointer~PointerInteraction


import PointerInteraction from 'ol/interaction/Pointer.js';

downmoveup 事件上调用用户定义函数的基类。此类还管理“拖拽序列”。

handleDownEvent 用户函数返回 true 时,开始拖拽序列。在拖拽序列期间,handleDragEvent 用户函数在 move 事件上被调用。当 handleUpEvent 用户函数被调用并返回 false 时,拖拽序列结束。

new PointerInteraction(options)

Name Type Description
handleDownEvent function | undefined

处理"按下"事件的函数。如果函数返回 true,则开始拖拽序列。

handleDragEvent function | undefined

处理"拖拽"事件的函数。此函数在拖拽序列期间的"移动"事件上调用。

handleEvent function | undefined

地图调用的方法,用于通知交互浏览器事件已分派到地图。函数可以返回 false 以防止事件传播到地图交互链中的其他交互。

handleMoveEvent function | undefined

处理"移动"事件的函数。此函数在"移动"事件上调用。此函数在拖拽序列期间也会被调用,因此在拖拽序列期间,handleDragEvent 函数和此函数都会被调用。如果定义了 handleDownEvent 且返回 true,则在拖拽序列期间不会调用此函数。

handleUpEvent function | undefined

处理"抬起"事件的函数。如果函数返回 false,则停止当前拖拽序列。

stopDown function | undefined

按下事件应传播到其他交互还是应停止?

触发事件:

Subclasses

Extends

Observable Properties

Name Type Settable ObjectEvent type Description
active boolean yes change:active

true 表示交互处于活动状态,否则为 false

Methods

增加修订计数器并分发 'change' 事件。

dispatchEvent(event){boolean | undefined} inherited

分发事件并调用所有监听此类型事件的监听器。事件参数可以是一个字符串或一个 具有 type 属性的对象。

Name Type Description
event BaseEvent | string

事件对象。

返回值:
如果有人在事件对象上调用了 preventDefault 或任何监听器返回 false,则返回 false

获取一个值。

Name Type Description
key string

键名。

返回值:
值。

返回交互当前是否激活。

返回值:
true 表示交互处于活动状态,否则为 false

getKeys(){Array.<string>} inherited

获取对象属性名列表。

返回值:
属性名列表。

获取与此交互关联的地图。

返回值:
地图。

getPointerCount(){number}

返回当前参与交互的指针数量,例如使用两根手指时为 2。

返回值:
The number of pointers.

getProperties(){NoInfer.<Properties>} inherited

获取包含所有属性名和值的对象。

返回值:
对象。

getRevision(){number} inherited

获取此对象的版本号。 每次对象被修改时,其版本号将递增。

返回值:
版本号。

handleEvent(mapBrowserEvent){boolean}

处理 地图浏览器事件,如果检测到如 'drag' 或 'down-up' 等事件序列,可能会调用其他函数。

Name Type Description
mapBrowserEvent MapBrowserEvent

地图浏览器事件。

返回值:
false to stop event propagation.

on(type, listener){EventsKey | Array<EventsKey>} inherited

监听特定类型的事件。

Name Type Description
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

返回值:
监听器的唯一键。如果第一个参数是事件类型数组,则返回键的数组。

once(type, listener){EventsKey | Array<EventsKey>} inherited

仅监听一次特定类型的事件。

Name Type Description
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

返回值:
监听器的唯一键。如果第一个参数是事件类型数组,则返回键的数组。

set(key, value, silent) inherited

设置一个值。

Name Type Description
key string

键名。

value *

值。

silent boolean | undefined

更新但不触发事件。

激活或停用交互。

Name Type Description
active boolean

是否激活。

setProperties(values, silent) inherited

设置一组键值对。 注意,这会更改任何现有属性并添加新属性(不会移除任何现有属性)。

Name Type Description
values Partial.<NoInfer.<Properties>>

值。

silent boolean | undefined

更新但不触发事件。

un(type, listener) inherited

取消监听特定类型的事件。

Name Type Description
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

unset(key, silent) inherited

取消设置一个属性。

Name Type Description
key string

键名。

silent boolean | undefined

取消设置但不触发事件。