OpenLayers. Handler. RegularPolygon

Handler to draw a regular polygon on the map.  Polygon is displayed on mouse down, moves or is modified on mouse move, and is finished on mouse up.  The handler triggers callbacks for ‘done’ and ‘cancel’.  Create a new instance with the OpenLayers.Handler.RegularPolygon constructor.

Inherits from

Summary
Handler to draw a regular polygon on the map.
{Integer} Number of sides for the regular polygon.
{Float} Optional radius in map units of the regular polygon.
{Float} If set to a non-zero value, the handler will snap the polygon rotation to multiples of the snapAngle.
{String} If set, snapToggle is checked on mouse events and will set the snap mode to the opposite of what it currently is.
{Boolean} Leave the feature rendered until clear is called.
Create a new regular polygon handler.
Turn on the handler.
Turn off the handler.
Finish the geometry and call the “cancel” callback.
Clear any rendered features on the temporary layer.

Properties

sides

{Integer} Number of sides for the regular polygon.  Needs to be greater than 2.  Defaults to 4.

radius

{Float} Optional radius in map units of the regular polygon.  If this is set to some non-zero value, a polygon with a fixed radius will be drawn and dragged with mose movements.  If this property is not set, dragging changes the radius of the polygon.  Set to null by default.

snapAngle

{Float} If set to a non-zero value, the handler will snap the polygon rotation to multiples of the snapAngle.  Value is an angle measured in degrees counterclockwise from the positive x-axis.

snapToggle

{String} If set, snapToggle is checked on mouse events and will set the snap mode to the opposite of what it currently is.  To disallow toggling between snap and non-snap mode, set freehandToggle to null.  Acceptable toggle values are ‘shiftKey’, ‘ctrlKey’, and ‘altKey’.  Snap mode is only possible if this.snapAngle is set to a non-zero value.

persist

{Boolean} Leave the feature rendered until clear is called.  Default is false.  If set to true, the feature remains rendered until clear is called, typically by deactivating the handler or starting another drawing.

Constructor

OpenLayers. Handler. RegularPolygon

Create a new regular polygon handler.

Parameters

control{OpenLayers.Control} The control that owns this handler
callbacks{Array} An object with a ‘done’ property whos value is a function to be called when the polygon drawing is finished.  The callback should expect to recieve a single argument, the polygon geometry.  If the callbacks object contains a ‘cancel’ property, this function will be called when the handler is deactivated while drawing.  The cancel should expect to receive a geometry.
options{Object} An object with properties to be set on the handler.  If the options.sides property is not specified, the number of sides will default to 4.

Functions

setOptions

setOptions: function (newOptions)

Parameters

newOptions{Object}

activate

activate: function()

Turn on the handler.

Return

{Boolean} The handler was successfully activated

deactivate

deactivate: function()

Turn off the handler.

Return

{Boolean} The handler was successfully deactivated

cancel

cancel: function()

Finish the geometry and call the “cancel” callback.

clear

clear: function()

Clear any rendered features on the temporary layer.  This is called when the handler is deactivated, canceled, or done (unless persist is true).

setOptions: function (newOptions)
activate: function()
Turn on the handler.
deactivate: function()
Turn off the handler.
cancel: function()
Finish the geometry and call the “cancel” callback.
clear: function()
Clear any rendered features on the temporary layer.
Create a new regular polygon handler.
Base class to construct a higher-level handler for event sequences.
Controls affect the display or behavior of the map.