StatusBarListener (org.gvsig.app.mainplugin 2.0.485 API)

java.lang.Object
- org.gvsig.app.project.documents.view.toolListeners.StatusBarListener

All Implemented Interfaces:

org.gvsig.fmap.mapcontrol.tools.Listeners.PointListener, org.gvsig.fmap.mapcontrol.tools.Listeners.ToolListener
```
public class StatusBarListener
extends java.lang.Object
implements org.gvsig.fmap.mapcontrol.tools.Listeners.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.
Author:

Vicente Caballero Navarro

Constructor Summary

Constructors
Constructor and Description

StatusBarListener(org.gvsig.fmap.mapcontrol.MapControl mc)
Creates a new StatusBarListener object.

Constructors
Constructor and Description
`StatusBarListener(org.gvsig.fmap.mapcontrol.MapControl mc)` Creates a new `StatusBarListener` object.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`cancelDrawing()`
`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.
`java.awt.Image`	`getImageCursor()`
`void`	`point(org.gvsig.fmap.mapcontrol.tools.Events.PointEvent event)`
`void`	`pointDoubleClick(org.gvsig.fmap.mapcontrol.tools.Events.PointEvent event)`
`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.
`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.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - StatusBarListener
```
public StatusBarListener(org.gvsig.fmap.mapcontrol.MapControl mc)
```
    Creates a new StatusBarListener object.
    
    Parameters:
    
    mc - the MapControl where will be applied the changes
- Method Detail
  - cancelDrawing
```
public boolean cancelDrawing()
```
    Specified by:
    
    cancelDrawing in interface org.gvsig.fmap.mapcontrol.tools.Listeners.ToolListener
  - 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
  - getImageCursor
```
public java.awt.Image getImageCursor()
```
    Specified by:
    
    getImageCursor in interface org.gvsig.fmap.mapcontrol.tools.Listeners.ToolListener
  - point
```
public void point(org.gvsig.fmap.mapcontrol.tools.Events.PointEvent event)
           throws org.gvsig.fmap.mapcontrol.tools.BehaviorException
```
    Specified by:
    
    point in interface org.gvsig.fmap.mapcontrol.tools.Listeners.PointListener
    
    Throws:
    
    org.gvsig.fmap.mapcontrol.tools.BehaviorException
  - pointDoubleClick
```
public void pointDoubleClick(org.gvsig.fmap.mapcontrol.tools.Events.PointEvent event)
                      throws org.gvsig.fmap.mapcontrol.tools.BehaviorException
```
    Specified by:
    
    pointDoubleClick in interface org.gvsig.fmap.mapcontrol.tools.Listeners.PointListener
    
    Throws:
    
    org.gvsig.fmap.mapcontrol.tools.BehaviorException
  - 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 = "
  - 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

Class StatusBarListener

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

StatusBarListener

Method Detail

cancelDrawing

getCoords

getImageCursor

point

pointDoubleClick

setCoorDisplayText

setFractionDigits