org.gvsig.app.project.documents.view.toolListeners

Class StatusBarListener

java.lang.Object

org.gvsig.app.project.documents.view.toolListeners.StatusBarListener

All Implemented Interfaces:

PointListener, ToolListener

public class StatusBarListener
extends java.lang.Object
implements PointListener

Listener that displays at the status bar of the application's main frame, the value of the point coordinates of the mouse's cursor on the associated MapControl, just as is received a PointEvent event.

Calculates the coordinates equivalent to the point according this rules:

• uses formatDegrees(p.get{X or Y}() if the associated MapControl object isn't projected.
• uses formatDegrees({MapControl's projection}.toGeo(p.get{X or Y}()) if the associated MapControl object is projected and its ViewPort's distance units are in degrees.
• uses {NumberFormat according to #setFractionDigits(Point2D)}.format((p.get{X or Y}()/MapContext.CHANGEM[mapControl.getViewPort().getDistanceUnits()])*MapContext.CHANGEM[mapControl.getViewPort().getMapUnits()]) otherwise.

The prefix of the coordinate expressions will be:

• Longitude "Long =" and latitude "Lat =", if the associated MapControl object isn't projected, or the current distance unit of the MapControl's view port is in degrees.
• X "X =" and Y "Y =", otherwise.

And the sufix value:

• If the associated MapControl object isn't projected, or the current distance unit of the MapControl's view port is in degrees(expected latitude or longitude), according this pattern:
  S?Gš M' S'', having:
  
  • S? : optionally, if the value is negative, sets a "-" symbol.
  • G : equivalent grades.
  • M : equivalent minutes.
  • S : equivalent seconds.
• Otherwise a decimal number according this rules:
  • 8 decimals, if is using any of the following geographic coordinate systems:
    • EPSG:4230 (known as ED50).
    • EPSG:4326 (known as WGS84).
  • 2 decimals, otherwise.

Constructor Summary

Constructors

Constructor and Description
StatusBarListener(MapControl mc) Creates a new StatusBarListener object.

Method Summary

Modifier and Type	Method and Description
boolean	cancelDrawing() Determines if the drawing process that this tool executes on the MapControl instance could be canceled or not.
java.lang.String[]	getCoords(java.awt.geom.Point2D p) Returns the coordinates equivalent to p: Uses formatDegrees(p.get{X or Y}() if the associated MapControl object isn't projected.
java.awt.Image	getImageCursor() Gets the Cursor associated to this tool.
void	point(PointEvent event) Called when one click is pressed on the associated MapControl, or the location of the cursor of the mouse has changed on it.
void	pointDoubleClick(PointEvent event) Called when a double click is pressed on the associated MapControl.
java.lang.String[]	setCoorDisplayText(java.lang.String[] axisText) Gets the name of the coordinates: Longitude and Latitude, if the associated MapControl object isn't projected, or the current distance unit of the MapControl's view port is in degrees.
void	setFractionDigits(java.awt.geom.Point2D p) Sets the number of decimals of the coordinates that will be displayed, according the current projection of the associated MapControl: 8 decimals, if is using geographical coordinates: EPSG:4230 (known as ED50).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StatusBarListener

public StatusBarListener(MapControl mc)

Creates a new StatusBarListener object.

Parameters:

mc - the MapControl where will be applied the changes

Method Detail

getImageCursor

public java.awt.Image getImageCursor()

Description copied from interface: ToolListener

Gets the Cursor associated to this tool.

Specified by:

getImageCursor in interface ToolListener

Returns:

component with the bitmap associated to this tool

cancelDrawing

public boolean cancelDrawing()

Description copied from interface: ToolListener

Determines if the drawing process that this tool executes on the MapControl instance could be canceled or not.

Specified by:

cancelDrawing in interface ToolListener

Returns:

true if is cancellable; otherwise returns false

point

public void point(PointEvent event)
           throws BehaviorException

Description copied from interface: PointListener

Called when one click is pressed on the associated MapControl, or the location of the cursor of the mouse has changed on it.

Specified by:

point in interface PointListener

Parameters:

event - mouse event with the coordinates of the point selected on the associated MapControl

Throws:

BehaviorException - will be thrown when fails the process of this tool

setFractionDigits

public void setFractionDigits(java.awt.geom.Point2D p)

Sets the number of decimals of the coordinates that will be displayed, according the current projection of the associated MapControl:

• 8 decimals, if is using geographical coordinates:
  • EPSG:4230 (known as ED50).
  • EPSG:4326 (known as WGS84).
• 2 decimals, otherwise.

Parameters:

p - unused parameter

setCoorDisplayText

public java.lang.String[] setCoorDisplayText(java.lang.String[] axisText)

Gets the name of the coordinates:

• Longitude and Latitude, if the associated MapControl object isn't projected, or the current distance unit of the MapControl's view port is in degrees.
• X and Y, otherwise.

Parameters:

p - array of at least two String, where text will be stored and returned

Returns:

text describing the coordinate value:

• If isn't projected:
  • String[0] : "Long = "
  • String[1] : "Lat = "
• Otherwise:
  • String[0] : "X = "
  • String[1] : "Y = "

getCoords

public java.lang.String[] getCoords(java.awt.geom.Point2D p)

Returns the coordinates equivalent to p:

• Uses formatDegrees(p.get{X or Y}() if the associated MapControl object isn't projected.
• Uses formatDegrees({MapControl's projection}.toGeo(p.get{X or Y}()) if the associated MapControl object is projected and its ViewPort's distance units are in degrees.
• Uses {NumberFormat according to #setFractionDigits(Point2D)}.format((p.get{X or Y}()/MapContext.CHANGEM[mapControl.getViewPort().getDistanceUnits()])*MapContext.CHANGEM[mapControl.getViewPort().getMapUnits()]) otherwise.

Parameters:

p - point 2D to convert in text coordinates according the projection of the associated MapControl and the distance units of its ViewPort.

Returns:

coordinates equivalent to p, according to the algorithm explained up

pointDoubleClick

public void pointDoubleClick(PointEvent event)
                      throws BehaviorException

Description copied from interface: PointListener

Called when a double click is pressed on the associated MapControl.

Specified by:

pointDoubleClick in interface PointListener

Parameters:

event - mouse event and the coordinates of the point selected on the associated MapControl

Throws:

BehaviorException - will be thrown when fails the process of this tool