SuperMap.Handler.Point

在地图上绘制点要素的事件处理器。绘制点在激活后显示,随着鼠标移动而移动,在鼠标松开后完成绘制。 该处理器会触发标记为”done”、”cancel”和“modify”的事件回调。其中modify回调会在每一次变化时被调用并传入最近一次绘制的点。 使用 SuperMap.Handler.Point 构造函数可以创建一个新的绘制点的事件处理器实例。

Inherits from

Summary
SuperMap.Handler.Point 在地图上绘制点要素的事件处理器。绘制点在激活后显示,随着鼠标移动而移动,在鼠标松开后完成绘制。 该处理器会触发标记为”done”、”cancel”和“modify”的事件回调。其中modify回调会在每一次变化时被调用并传入最近一次绘制的点。 使用 SuperMap.Handler.Point 构造函数可以创建一个新的绘制点的事件处理器实例。
Properties
layerOptions {Object} 临时绘制图层的可选属性,可用来设置图层的样式。
multi {Boolean} 在传递事件到图层leyer之前,为多个节点的几何对象创建feature要素实例。默认值是false。
persist {Boolean} 保留呈现的feature要素直到destroyFeature方法被调用。默认为false。 如果设置为true,那么feature会保持呈现,直到handler被设置为无效或者开启另一次绘制的时候调用destroyFeature方法来清除。
pixelTolerance {Number} 绘制点像素容差。绘制点操作所允许的鼠标down和up(包括普通的mousedown、mouseup和touchstart、touchend) 事件之间的最大像素间隔。 如果设置为有效的integer值,则当鼠标down和up之间间隔超过该值时将被忽略,不会添加点要素。默认值是 5。
stopDown {Boolean} 停止鼠标mousedown事件的传播。在允许”绘制过程中平移”的时候必须设置为false。默认值为false。
Constructor
SuperMap.Handler.Point 构造函数,创建一个新的绘制点要素的事件处理器。
Functions
activate 激活事件处理器对象上的监听处理,如果这个事件处理器对象已经激活,则返回false.
cancel 结束绘制操作并且调用cancel回调
deactivate 关闭事件处理器对象上的监听处理,如果这个事件处理器已经是关闭状态,则返回false

Properties

multi

{Boolean} 在传递事件到图层leyer之前,为多个节点的几何对象创建feature要素实例。默认值是false。

persist

{Boolean} 保留呈现的feature要素直到destroyFeature方法被调用。默认为false。 如果设置为true,那么feature会保持呈现,直到handler被设置为无效或者开启另一次绘制的时候调用destroyFeature方法来清除。

stopDown

{Boolean} 停止鼠标mousedown事件的传播。在允许”绘制过程中平移”的时候必须设置为false。默认值为false。

layerOptions

{Object} 临时绘制图层的可选属性,可用来设置图层的样式。

pixelTolerance

{Number} 绘制点像素容差。绘制点操作所允许的鼠标down和up(包括普通的mousedown、mouseup和touchstart、touchend) 事件之间的最大像素间隔。 如果设置为有效的integer值,则当鼠标down和up之间间隔超过该值时将被忽略,不会添加点要素。默认值是 5。

Constructor

SuperMap.Handler.Point

构造函数,创建一个新的绘制点要素的事件处理器。

Parameters

control {SuperMap.Control} 构建当前事件处理器的控件对象。
callbacks {Object} 回调函数对象。关于回调的具体描述参见下文。
options {Object} 一个可选对象,其属性将会赋值到事件处理器对象上。

Named callbacks

create 当要素草图第一次创建的时候调用,回调函数需接收两个参数:当前点几何对象、当前要素。
modify 顶点的每一次变化时调用,回调函数接受参数:几何点对象、当前要素。
done 当绘制点操作完成时调用,回调函数接收一个参数,当前点的几何对象。
cancel 绘制过程中关闭当前事件处理器的监听时调用,回调函数接收当前要素的几何对象作为参数。

Functions

activate

activate: function()

激活事件处理器对象上的监听处理,如果这个事件处理器对象已经激活,则返回false.

Returns

{Boolean} 事件处理器对象监听激活成功.

deactivate

deactivate: function()

关闭事件处理器对象上的监听处理,如果这个事件处理器已经是关闭状态,则返回false

Returns

{Boolean} 事件处理器对象监听已经成功关闭。

cancel

cancel: function()

结束绘制操作并且调用cancel回调

构造函数,创建一个新的绘制点要素的事件处理器。
activate: function()
激活事件处理器对象上的监听处理,如果这个事件处理器对象已经激活,则返回false.
deactivate: function()
关闭事件处理器对象上的监听处理,如果这个事件处理器已经是关闭状态,则返回false
cancel: function()
结束绘制操作并且调用cancel回调
用于处理Control事件的事件处理器。 事件处理器(Handler)内部封装了浏览器事件监听及其相应的处理方法,当一个事件处理器被激活时, Handler中定义的浏览器事件监听及其相应的方法被注册到浏览器监听器,在浏览器事件被触发之后, 首先会调用Handler中处理该浏览器事件的方法来做事件的确认和信息封装,然后才再传递给Control等做具体响应处理。 当一个处理器被注销,这些方法在事件监听器中也会相应的被取消注册。
控件类,提供了多种控件,比如比例尺控件,鹰眼控件,缩放条控件等等。 用于处理 Control 事件的事件处理器 Handler,内部封装了一系列的浏览器事件, 在控件(control)实现过程中可调用Handler,通过 active和 deactive两个方法,实现动态的激活和注销。
Close