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 )