地图上绘制规则多边形的处理事件类。多边形在按下鼠标的时候开始显示，然后跟随鼠标移动和方位修改做出变化，最后在鼠标 松开的时候完成绘制。该处理事件会触发”done”和”cancel”标记的回调函数。 使用 SuperMap.Handler.RegularPolygon 构造方法可以创建一个新的handler实例。
| SuperMap. |
地图上绘制规则多边形的处理事件类。多边形在按下鼠标的时候开始显示，然后跟随鼠标移动和方位修改做出变化，最后在鼠标 松开的时候完成绘制。该处理事件会触发”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. |
构造方法，返回一个绘制规则多边形的处理器。 |
| Functions | |
| activate | 激活处理器对象上的监听处理，如果当前处理器对象已经激活，则返回false. |
| cancel | 结束多边形绘制并调用cancel回调。 |
| clear | 清理临时图层上呈现的要素。方法会在处理器激活状态被关闭、取消、或者完成操作（persist为true的情况）时调用。 |
| deactivate | 关闭处理器对象上的监听处理，如果当前处理器已经是关闭状态，则返回false |
| setOptions | 设置可选属性。 |
构造方法，返回一个绘制规则多边形的处理器。
| control | {SuperMap.Control} 当前处理器所属的控件对象。 |
| callbacks | {Object} 回调函数对象，详细描述参见下文。 |
| options | {Object} 一个可选对象，其属性将会赋值到处理器对象上。如果side属性没有设置特定值，则默认为4。 |
| create | 要素被初次创建时候调用，回调函数接收创建的集合点对象和多边形要素作为参数。 |
| done | 多边形要素完成绘制时调用，回调函数接收多边形要素的几何对象作为唯一参数。 |
| cancel | 当前处理器激活状态在绘制过程中被关闭时调用。回调函数接收当前要素的几何对象作为参数。 |
设置可选属性。
setOptions: function ( newOptions )
激活处理器对象上的监听处理，如果当前处理器对象已经激活，则返回false.
activate: function()
关闭处理器对象上的监听处理，如果当前处理器已经是关闭状态，则返回false
deactivate: function()
结束多边形绘制并调用cancel回调。
cancel: function()
清理临时图层上呈现的要素。方法会在处理器激活状态被关闭、取消、或者完成操作（persist为true的情况）时调用。
clear: function()