Class: Tool

OM.tool. Tool


new Tool(map)

Tool is the base class for various types of map tools such as those used
for distance measuring, marquee zooming and drawing custom shapes.

All Tool instances fire various events which are instances of OM.event.ToolEvent.
Application can listen on any of the applicable events to customize the
behavior of the tool instance.

Parameters:
Name Type Description
map OM.Map

The map instance to be associated with this tool.

Mixes In:
Fires:
  • event:ToolEvent

Methods


getGeometry()

Get the generated geometry. This should typically be called from
inside an event listener that is registered to the tool's life cycle
event such as OM.event.ToolEvent.TOOL_END.

Returns:

the geometry created by the tool

Type
OM.geometry.Geometry

getStatus()

Get the tool's status. Can be one of OM.tool.Tool.STARTED, OM.tool.Tool.STOPPED, or OM.tool.Tool.FINISHED

Returns:

tool status

Type
int

on()

A shorthand name for the member function addListener.

Mixes In:

setDrawingStyle(style)

Set the line drawing style

Parameters:
Name Type Description
style OM.style.Line

A line style used to
display the shape boundary as the user is drawing it.

Returns:

The tool instance

Type
OM.tool.Tool

setStyle(style)

Set rendering style for the completed feature

Parameters:
Name Type Description
style OM.Style

The style to be used for the completed shape

Returns:

The tool instance

Type
OM.tool.Tool

setZeroSizeAllowed(flag)

Sets whether this tool allows creation of zero-sized rectangles.
Default is disabled with a warning in console log.
Note: currently, it applies only to RectangleTool and CircleTool

Parameters:
Name Type Description
flag boolean

if true then zero-sized rectangles are allowed;
false otherwise.