SuperMap.Handler.RegularPolygon

地图上绘制规则多边形的处理事件类。多边形在按下鼠标的时候开始显示,然后跟随鼠标移动和方位修改做出变化,最后在鼠标 松开的时候完成绘制。该处理事件会触发”done”和”cancel”标记的回调函数。 使用 SuperMap.Handler.RegularPolygon 构造方法可以创建一个新的handler实例。

Inherits from

Summary
SuperMap.Handler.RegularPolygon 地图上绘制规则多边形的处理事件类。多边形在按下鼠标的时候开始显示,然后跟随鼠标移动和方位修改做出变化,最后在鼠标 松开的时候完成绘制。该处理事件会触发”done”和”cancel”标记的回调函数。 使用 SuperMap.Handler.RegularPolygon 构造方法可以创建一个新的handler实例。
Properties
irregular {Boolean} 绘制一个不规则的多边形来代替一个规则的多边形。默认为false。 如果设置为true,则在第一次鼠标按下时标明多边形边界的一个角,并且随着鼠标的移动绘制其对角点,进而拉伸多边形。 该属性优先级高于radius属性,如果设置为true,radius则会被忽略。
persist {Boolean} 保留要素呈现直到清理方法被调用。默认值是 false。 如果设置为true,则会保留要素呈现,直到关闭当前处理器激活状态或者开启另个绘制时,调用clear方法实施清理。
radius {Float} 以地图单位标记的规则多边形半径。如果设置为非零有效值,则在鼠标移动和拖拽过程中将会绘制一个固定半径的 规则多边形。如果这个属性没有设置,可以通过鼠标拖拽来改变多边形的大小。默认值为 null。
sides {Integer} 规则多边形的边的数量,要求必须大于2。默认的值为4
snapAngle {Float} 如果设置了非零值,则操作过程中会按照snapAngle值整倍数来旋转多边形。 这个值是沿x轴正方向逆时针旋转的角度。
snapToggle {String} 如果设置,则对应设置的键盘key事件会在鼠标事件过程中得到捕获,并且设置snap模式为与当前相反的模式。 可以通过设置freehandToggle为null来阻止snap和none-snap模式之间的切换。允许设置的snapToggle值为:”shiftKey”、 “ctrlKey”、”altKey”。 在snapAngle设置为非零值的情况下只有snap模式可用。默认值为 “shiftKey”。
Constructor
SuperMap.Handler.RegularPolygon 构造方法,返回一个绘制规则多边形的处理器。
Functions
activate 激活处理器对象上的监听处理,如果当前处理器对象已经激活,则返回false.
cancel 结束多边形绘制并调用cancel回调。
clear 清理临时图层上呈现的要素。方法会在处理器激活状态被关闭、取消、或者完成操作(persist为true的情况)时调用。
deactivate 关闭处理器对象上的监听处理,如果当前处理器已经是关闭状态,则返回false
setOptions 设置可选属性。

Properties

sides

{Integer} 规则多边形的边的数量,要求必须大于2。默认的值为4

radius

{Float} 以地图单位标记的规则多边形半径。如果设置为非零有效值,则在鼠标移动和拖拽过程中将会绘制一个固定半径的 规则多边形。如果这个属性没有设置,可以通过鼠标拖拽来改变多边形的大小。默认值为 null。

snapAngle

{Float} 如果设置了非零值,则操作过程中会按照snapAngle值整倍数来旋转多边形。 这个值是沿x轴正方向逆时针旋转的角度。

snapToggle

{String} 如果设置,则对应设置的键盘key事件会在鼠标事件过程中得到捕获,并且设置snap模式为与当前相反的模式。 可以通过设置freehandToggle为null来阻止snap和none-snap模式之间的切换。允许设置的snapToggle值为:”shiftKey”、 “ctrlKey”、”altKey”。 在snapAngle设置为非零值的情况下只有snap模式可用。默认值为 “shiftKey”。

persist

{Boolean} 保留要素呈现直到清理方法被调用。默认值是 false。 如果设置为true,则会保留要素呈现,直到关闭当前处理器激活状态或者开启另个绘制时,调用clear方法实施清理。

irregular

{Boolean} 绘制一个不规则的多边形来代替一个规则的多边形。默认为false。 如果设置为true,则在第一次鼠标按下时标明多边形边界的一个角,并且随着鼠标的移动绘制其对角点,进而拉伸多边形。 该属性优先级高于radius属性,如果设置为true,radius则会被忽略。

Constructor

SuperMap.Handler.RegularPolygon

构造方法,返回一个绘制规则多边形的处理器。

Parameters

control {SuperMap.Control} 当前处理器所属的控件对象。
callbacks {Object} 回调函数对象,详细描述参见下文。
options {Object} 一个可选对象,其属性将会赋值到处理器对象上。如果side属性没有设置特定值,则默认为4。

Named callbacks

create 要素被初次创建时候调用,回调函数接收创建的集合点对象和多边形要素作为参数。
done 多边形要素完成绘制时调用,回调函数接收多边形要素的几何对象作为唯一参数。
cancel 当前处理器激活状态在绘制过程中被关闭时调用。回调函数接收当前要素的几何对象作为参数。

Functions

setOptions

setOptions: function ( newOptions )

设置可选属性。

Parameters

newOptions {Object} 为当前处理器设置可选属性。

activate

activate: function()

激活处理器对象上的监听处理,如果当前处理器对象已经激活,则返回false.

Returns

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

deactivate

deactivate: function()

关闭处理器对象上的监听处理,如果当前处理器已经是关闭状态,则返回false

Returns

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

cancel

cancel: function()

结束多边形绘制并调用cancel回调。

clear

clear: function()

清理临时图层上呈现的要素。方法会在处理器激活状态被关闭、取消、或者完成操作(persist为true的情况)时调用。

构造方法,返回一个绘制规则多边形的处理器。
setOptions: function ( newOptions )
设置可选属性。
activate: function()
激活处理器对象上的监听处理,如果当前处理器对象已经激活,则返回false.
deactivate: function()
关闭处理器对象上的监听处理,如果当前处理器已经是关闭状态,则返回false
cancel: function()
结束多边形绘制并调用cancel回调。
clear: function()
清理临时图层上呈现的要素。方法会在处理器激活状态被关闭、取消、或者完成操作(persist为true的情况)时调用。
拖拽事件的事件处理器,用来处理与拖拽有关的一系列浏览器事件。控件使用该处理器获知拖拽事件的开始,发生和结束。
控件类,提供了多种控件,比如比例尺控件,鹰眼控件,缩放条控件等等。 用于处理 Control 事件的事件处理器 Handler,内部封装了一系列的浏览器事件, 在控件(control)实现过程中可调用Handler,通过 active和 deactive两个方法,实现动态的激活和注销。
Close