Class: AreaTool

new AreaTool(optionsopt) [source]

var areaTool = new AreaTool({
    'once' : true,
    'symbol': {
      'lineColor' : '#34495e',
      'lineWidth' : 2
    },
    'vertexSymbol' : {
      'markerType'        : 'ellipse',
      'markerFill'        : '#1bbc9b',
      'markerLineColor'   : '#000',
      'markerLineWidth'   : 3,
      'markerWidth'       : 10,
     'markerHeight'      : 10
   },
   'language' : 'en-US'
 }).addTo(map);

Parameter Type Default Description

options opt

options

null

construct options

Properties

Parameter	Type	Default	Description
`language` opt	String	zh-CN	language of the distance tool, zh-CN or en-US
`metric` opt	Boolean	true	display result in metric system
`imperial` opt	Boolean	false	display result in imperial system.
`symbol` opt	Object	null	symbol of the line
`vertexSymbol` opt	Object	null	symbol of the vertice
`labelOptions` opt	Object	null	construct options of the vertice labels.

Extends:

DistanceTool

Members

(constant) options

Properties:

Name Type Description

options

options

Properties

Name	Type	Default	Description
`language`	String		language of the distance tool, zh-CN or en-US
`metric`	Boolean		display result in metric system
`imperial`	Boolean		display result in imperial system.
`symbol`	Object		symbol of the line
`vertexSymbol`	Object		symbol of the vertice
`labelOptions`	Object		construct options of the vertice labels.
`mode` opt	String	null	mode of the draw tool
`once` opt	Boolean	null	whether disable immediately once drawn a geometry.
`autoPanAtEdge` opt	Boolean	false	Whether to make edge judgement or not.

Overrides:

DistanceTool#options

Source:

map/tool/AreaTool.js, line 16

Methods

(inherited) clear() [source]

Clear the measurements

Inherited From:

DistanceTool#clear

Returns:

DistanceTool: this

(inherited) getMeasureLayers() [source]

Get the VectorLayers with the geometries drawn on the map during measuring.

Inherited From:

DistanceTool#getMeasureLayers

Returns:

Array.<Layer>:

(inherited) getLastMeasure() [source]

Get last measuring result

Inherited From:

DistanceTool#getLastMeasure

Returns:

Number:

(inherited) getMode() [source]

Get current mode of draw tool

Inherited From:

DrawTool#getMode

Returns:

String: mode

(inherited) setMode(mode) [source]

Set mode of the draw tool

Parameter	Type	Description
`mode`	String	mode of the draw tool

Inherited From:

DrawTool#setMode

(inherited) getSymbol() [source]

Get symbol of the draw tool

Inherited From:

DrawTool#getSymbol

Returns:

Object: symbol

(inherited) setSymbol(symbol) [source]

Set draw tool's symbol

Parameter	Type	Description
`symbol`	Object	symbol set

Inherited From:

DrawTool#setSymbol

Returns:

DrawTool: this

(inherited) getCurrentGeometry() [source]

Get geometry is currently drawing

Inherited From:

DrawTool#getCurrentGeometry

Returns:

Geometry: geometry currently drawing

(inherited) undo() [source]

Undo drawing, only applicable for click/dblclick mode

Inherited From:

DrawTool#undo

Returns:

DrawTool: this

(inherited) redo() [source]

Redo drawing, only applicable for click/dblclick mode

Inherited From:

DrawTool#redo

Returns:

DrawTool: this

(inherited) endDraw(paramopt) [source]

End current draw

Parameter	Type	Default	Description
`param` opt	Object	null	params of drawend event

Inherited From:

DrawTool#endDraw

Returns:

DrawTool: this

(inherited) addTo(map) [source]

Adds the map tool to a map.

Parameter	Type	Description
`map`	Map

Inherited From:

MapTool#addTo

Fires:

Returns:

MapTool: this

(inherited) getMap() [source]

Gets the map it added to.

Inherited From:

MapTool#getMap

Returns:

Map: map

(inherited) enable() [source]

Enable the map tool.

Inherited From:

MapTool#enable

Fires:

enable

Returns:

MapTool: this

(inherited) disable() [source]

Disable the map tool

Inherited From:

MapTool#disable

Fires:

disable

Returns:

MapTool: this

(inherited) isEnabled() [source]

Returns whether the tool is enabled

Inherited From:

MapTool#isEnabled

Returns:

Boolean: true | false

(inherited) on(eventsOn, handler, contextopt) [source]

foo.on('mousedown mousemove mouseup', onMouseEvent, foo);

Parameter	Type	Default	Description
`eventsOn`	String		event types to register, seperated by space if more than one.
`handler`	function		handler function to be called
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.on

Inherited From:

MapTool#on

Returns:

Any: this

(inherited) addEventListener(eventTypes, handler, contextopt) [source]

Alias for on

Parameter	Type	Default	Description
`eventTypes`	String		event types to register, seperated by space if more than one.
`handler`	function		handler function to be called
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.addEventListener

Inherited From:

MapTool#addEventListener

Returns:

: this

(inherited) once(eventTypes, handler, contextopt) [source]

Same as on, except the listener will only get fired once and then removed.

foo.once('mousedown mousemove mouseup', onMouseEvent, foo);

Parameter	Type	Default	Description
`eventTypes`	String		event types to register, seperated by space if more than one.
`handler`	function		listener handler
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.once

Inherited From:

MapTool#once

Returns:

: this

(inherited) off(eventsOff, handler, contextopt) [source]

Unregister the event handler for the specified event types.

foo.off('mousedown mousemove mouseup', onMouseEvent, foo);

Parameter	Type	Default	Description
`eventsOff`	String		event types to unregister, seperated by space if more than one.
`handler`	function		listener handler
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.off

Inherited From:

MapTool#off

Returns:

: this

(inherited) removeEventListener(eventTypes, handler, contextopt) [source]

Alias for off

Parameter	Type	Default	Description
`eventTypes`	String		event types to unregister, seperated by space if more than one.
`handler`	function		listener handler
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.removeEventListener

Inherited From:

MapTool#removeEventListener

Returns:

: this

(inherited) listens(eventType, hanlderopt, contextopt) [source]

Returns listener's count registered for the event type.

Parameter	Type	Default	Description
`eventType`	String		an event type
`hanlder` opt	function	null	listener function
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.listens

Inherited From:

MapTool#listens

Returns:

Number:

(inherited) copyEventListeners(target) [source]

Copy all the event listener to the target object

Parameter	Type	Description
`target`	Object	target object to copy to.

Mixes From:

Eventable.copyEventListeners

Inherited From:

MapTool#copyEventListeners

Returns:

: this

(inherited) fire(eventType, param) [source]

Fire an event, causing all handlers for that event name to run.

Parameter	Type	Description
`eventType`	String	an event type to fire
`param`	Object	parameters for the listener function.

Mixes From:

Eventable.fire

Inherited From:

MapTool#fire

Returns:

: this

(inherited) callInitHooks() [source]

Visit and call all the init hooks defined on Class and its parents.

Inherited From:

Class#callInitHooks

Returns:

Class: this

(inherited) setOptions(options) [source]

Merges options with the default options of the object.

Parameter	Type	Description
`options`	Object	options to set

Inherited From:

Class#setOptions

Returns:

Class: this

(inherited) config(conf) [source]

1. Return object's options if no parameter is provided.
2. update an option and enable/disable the handler if a handler with the same name existed.

// Get marker's options;
var options = marker.config();
// Set map's option "draggable" to false and disable map's draggable handler.
map.config('draggable', false);
// You can update more than one options like this:
map.config({
    'scrollWheelZoom' : false,
    'doubleClickZoom' : false
});

Parameter	Type	Description
`conf`	Object	config to update

Inherited From:

Class#config

Returns:

Class: this

(inherited) onConfig() [source]

Default callback when config is called

Inherited From:

Class#onConfig

Events

(inherited) drawvertex [source]

drawvertex event.

Inherited From:

DrawTool#event:drawvertex

Properties:

Name	Type	Description
`type`	String	drawvertex
`target`	DrawTool	draw tool
`geometry`	Geometry	geometry drawn
`coordinate`	Coordinate	coordinate of the event
`containerPoint`	Point	container point of the event
`viewPoint`	Point	view point of the event
`domEvent`	Event	dom event

Inherited From:

DrawTool#event:drawvertex

Source:

map/tool/DrawTool.js, line 359

(inherited) drawstart [source]

drawstart event.

Inherited From:

DrawTool#event:drawstart

Properties:

Name	Type	Description
`type`	String	drawstart
`target`	DrawTool	draw tool
`coordinate`	Coordinate	coordinate of the event
`containerPoint`	Point	container point of the event
`viewPoint`	Point	view point of the event
`domEvent`	Event	dom event

Inherited From:

DrawTool#event:drawstart

Source:

map/tool/DrawTool.js, line 400

(inherited) mousemove [source]

mousemove event.

Inherited From:

DrawTool#event:mousemove

Properties:

Name	Type	Description
`type`	String	mousemove
`target`	DrawTool	draw tool
`geometry`	Geometry	geometry drawn
`coordinate`	Coordinate	coordinate of the event
`containerPoint`	Point	container point of the event
`viewPoint`	Point	view point of the event
`domEvent`	Event	dom event

Inherited From:

DrawTool#event:mousemove

Source:

map/tool/DrawTool.js, line 448

(inherited) drawend [source]

drawend event.

Inherited From:

DrawTool#event:drawend

Properties:

Name	Type	Description
`type`	String	drawend
`target`	DrawTool	draw tool
`geometry`	Geometry	geometry drawn
`coordinate`	Coordinate	coordinate of the event
`containerPoint`	Point	container point of the event
`viewPoint`	Point	view point of the event
`domEvent`	Event	dom event