Handler to draw a point on the map. Point is displayed on mouse down, moves 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.Point constructor.
OpenLayers. Handler. Point | Handler to draw a point on the map. |
Properties | |
point | {OpenLayers.Feature.Vector} The currently drawn point |
layer | {OpenLayers.Layer.Vector} The temporary drawing layer |
multi | {Boolean} Cast features to multi-part geometries before passing to the layer. |
drawing | {Boolean} A point is being drawn |
mouseDown | {Boolean} The mouse is down |
lastDown | {OpenLayers.Pixel} Location of the last mouse down |
lastUp | {OpenLayers.Pixel} |
persist | {Boolean} Leave the feature rendered until destroyFeature is called. |
layerOptions | {Object} Any optional properties to be set on the sketch layer. |
Constructor | |
OpenLayers. Handler. Point | Create a new point handler. |
Functions | |
activate | turn on the handler |
createFeature | Add temporary features |
deactivate | turn off the handler |
destroyFeature | Destroy the temporary geometries |
finalize | Finish the geometry and call the “done” callback. |
cancel | Finish the geometry and call the “cancel” callback. |
click | Handle clicks. |
dblclick | Handle double-clicks. |
drawFeature | Render features on the temporary layer. |
getGeometry | Return the sketch geometry. |
geometryClone | Return a clone of the relevant geometry. |
mousedown | Handle mouse down. |
mousemove | Handle mouse move. |
mouseup | Handle mouse up. |
{OpenLayers.Feature.Vector} The currently drawn point
{OpenLayers.Layer.Vector} The temporary drawing layer
{OpenLayers.Pixel} Location of the last mouse down
Create a new point handler.
control | {OpenLayers.Control} The control that owns this handler |
callbacks | {Object} An object with a ‘done’ property whose value is a function to be called when the point drawing is finished. The callback should expect to recieve a single argument, the point 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 optional object with properties to be set on the handler |
getGeometry: function()
Return the sketch geometry. If multi is true, this will return a multi-part geometry.
turn on the handler
activate: function()
Add temporary features
createFeature: function()
turn off the handler
deactivate: function()
Destroy the temporary geometries
destroyFeature: function()
Finish the geometry and call the “done” callback.
finalize: function( cancel )
Finish the geometry and call the “cancel” callback.
cancel: function()
Handle clicks.
click: function( evt )
Handle double-clicks.
dblclick: function( evt )
Render features on the temporary layer.
drawFeature: function()
Return the sketch geometry.
getGeometry: function()
Return a clone of the relevant geometry.
geometryClone: function()
Handle mouse down.
mousedown: function( evt )
Handle mouse move.
mousemove: function ( evt )
Handle mouse up.
mouseup: function ( evt )