Class: DragZoom

ol/interaction/DragZoom~DragZoom


import DragZoom from 'ol/interaction/DragZoom.js';

允许用户通过在地图上点击并拖动来缩放地图,通常与ol/events/condition结合使用,将其限制为仅在按住键(默认为 Shift)时触发。

要更改方框的样式,请使用 CSS 和 .ol-dragzoom 选择器,或使用 className 配置的自定义选择器。

new DragZoom(options)

Name Type Description
className string (defaults to 'ol-dragzoom')

用于样式化方框的 CSS 类名。

condition Condition | undefined

一个接受MapBrowserEvent并返回布尔值以指示是否应处理该事件的函数。默认为shiftKeyOnly

duration number (defaults to 200)

动画持续时间,以毫秒为单位。

out boolean (defaults to false)

使用此交互进行缩小操作。

minArea number (defaults to 64)

方框的最小面积(像素),此值由父级默认的 boxEndCondition 函数使用。

触发事件:

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

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

返回值:
指针数量。

getProperties(){NoInfer.<Properties>} inherited

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

返回值:
对象。

getRevision(){number} inherited

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

返回值:
版本号。

handleEvent(mapBrowserEvent){boolean} inherited

处理地图浏览器事件,如果检测到如"拖拽"或"按下-抬起"等事件序列,可能会调用其他函数。

Name Type Description
mapBrowserEvent MapBrowserEvent

地图浏览器事件。

返回值:
false 以停止事件传播。

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

取消设置但不触发事件。