|
/* Copyright (c) 2006-2010 by OpenLayers Contributors (see authors.txt for |
|
* full list of contributors). Published under the Clear BSD license. |
|
* See http://svn.openlayers.org/trunk/openlayers/license.txt for the |
|
* full text of the license. */ |
|
|
|
|
|
/** |
|
* @requires OpenLayers/Control.js |
|
*/ |
|
|
|
/** |
|
* Class: OpenLayers.Control.MousePosition |
|
* The MousePosition control displays geographic coordinates of the mouse |
|
* pointer, as it is moved about the map. |
|
* |
|
* Inherits from: |
|
* - <OpenLayers.Control> |
|
*/ |
|
OpenLayers.Control.MousePosition = OpenLayers.Class(OpenLayers.Control, { |
|
|
|
/** |
|
* APIProperty: autoActivate |
|
* {Boolean} Activate the control when it is added to a map. Default is |
|
* true. |
|
*/ |
|
autoActivate: true, |
|
|
|
/** |
|
* Property: element |
|
* {DOMElement} |
|
*/ |
|
element: null, |
|
|
|
/** |
|
* APIProperty: prefix |
|
* {String} |
|
*/ |
|
prefix: '', |
|
|
|
/** |
|
* APIProperty: separator |
|
* {String} |
|
*/ |
|
separator: ', ', |
|
|
|
/** |
|
* APIProperty: suffix |
|
* {String} |
|
*/ |
|
suffix: '', |
|
|
|
/** |
|
* APIProperty: numDigits |
|
* {Integer} |
|
*/ |
|
numDigits: 5, |
|
|
|
/** |
|
* APIProperty: granularity |
|
* {Integer} |
|
*/ |
|
granularity: 10, |
|
|
|
/** |
|
* APIProperty: emptyString |
|
* {String} Set this to some value to set when the mouse is outside the |
|
* map. |
|
*/ |
|
emptyString: null, |
|
|
|
/** |
|
* Property: lastXy |
|
* {<OpenLayers.Pixel>} |
|
*/ |
|
lastXy: null, |
|
|
|
/** |
|
* APIProperty: displayProjection |
|
* {<OpenLayers.Projection>} The projection in which the |
|
* mouse position is displayed |
|
*/ |
|
displayProjection: null, |
|
|
|
/** |
|
* Constructor: OpenLayers.Control.MousePosition |
|
* |
|
* Parameters: |
|
* options - {Object} Options for control. |
|
*/ |
|
initialize: function(options) { |
|
OpenLayers.Control.prototype.initialize.apply(this, arguments); |
|
}, |
|
|
|
/** |
|
* Method: destroy |
|
*/ |
|
destroy: function() { |
|
this.deactivate(); |
|
OpenLayers.Control.prototype.destroy.apply(this, arguments); |
|
}, |
|
|
|
/** |
|
* APIMethod: activate |
|
*/ |
|
activate: function() { |
|
if (OpenLayers.Control.prototype.activate.apply(this, arguments)) { |
|
this.map.events.register('mousemove', this, this.redraw); |
|
this.map.events.register('mouseout', this, this.reset); |
|
this.redraw(); |
|
return true; |
|
} else { |
|
return false; |
|
} |
|
}, |
|
|
|
/** |
|
* APIMethod: deactivate |
|
*/ |
|
deactivate: function() { |
|
if (OpenLayers.Control.prototype.deactivate.apply(this, arguments)) { |
|
this.map.events.unregister('mousemove', this, this.redraw); |
|
this.map.events.unregister('mouseout', this, this.reset); |
|
this.element.innerHTML = ""; |
|
return true; |
|
} else { |
|
return false; |
|
} |
|
}, |
|
|
|
/** |
|
* Method: draw |
|
* {DOMElement} |
|
*/ |
|
draw: function() { |
|
OpenLayers.Control.prototype.draw.apply(this, arguments); |
|
|
|
if (!this.element) { |
|
this.div.left = ""; |
|
this.div.top = ""; |
|
this.element = this.div; |
|
} |
|
|
|
return this.div; |
|
}, |
|
|
|
/** |
|
* Method: redraw |
|
*/ |
|
redraw: function(evt) { |
|
|
|
var lonLat; |
|
|
|
if (evt == null) { |
|
this.reset(); |
|
return; |
|
} else { |
|
if (this.lastXy == null || |
|
Math.abs(evt.xy.x - this.lastXy.x) > this.granularity || |
|
Math.abs(evt.xy.y - this.lastXy.y) > this.granularity) |
|
{ |
|
this.lastXy = evt.xy; |
|
return; |
|
} |
|
|
|
lonLat = this.map.getLonLatFromPixel(evt.xy); |
|
if (!lonLat) { |
|
// map has not yet been properly initialized |
|
return; |
|
} |
|
if (this.displayProjection) { |
|
lonLat.transform(this.map.getProjectionObject(), |
|
this.displayProjection ); |
|
} |
|
this.lastXy = evt.xy; |
|
|
|
} |
|
|
|
var newHtml = this.formatOutput(lonLat); |
|
|
|
if (newHtml != this.element.innerHTML) { |
|
this.element.innerHTML = newHtml; |
|
} |
|
}, |
|
|
|
/** |
|
* Method: reset |
|
*/ |
|
reset: function(evt) { |
|
if (this.emptyString != null) { |
|
this.element.innerHTML = this.emptyString; |
|
} |
|
}, |
|
|
|
/** |
|
* Method: formatOutput |
|
* Override to provide custom display output |
|
* |
|
* Parameters: |
|
* lonLat - {<OpenLayers.LonLat>} Location to display |
|
*/ |
|
formatOutput: function(lonLat) { |
|
var digits = parseInt(this.numDigits); |
|
var newHtml = |
|
this.prefix + |
|
lonLat.lon.toFixed(digits) + |
|
this.separator + |
|
lonLat.lat.toFixed(digits) + |
|
this.suffix; |
|
return newHtml; |
|
}, |
|
|
|
CLASS_NAME: "OpenLayers.Control.MousePosition" |
|
}); |
|
|