ilog.views.maps.beans
Class IlvJCoordinateViewer

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JLabel
                  ilog.views.maps.beans.IlvJCoordinateViewer

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

public class IlvJCoordinateViewer
extends JLabel

This class defines a Swing text field that can display the coordinates of the mouse when it is on top of an IlvManagerView displaying a map.

The coordinates can be displayed in two modes:

• CARTESIAN_MODE: The coordinates are displayed in the coordinate system of the manager.
• DMS_MODE: The coordinates are displayed in degrees, minutes and seconds as in a geographic coordinate system. This mode works only if the manager of the view that controls the coordinate viewer has an IlvCoordinateSystemProperty. The coordinate viewer will then use this property to convert the mouse coordinates in the geographic coordinate system, if the conversion is possible.

Note : Before JViews 5.0, georeferencing information used to be stored in an IlvProjectionProperty. As of JViews 5.0, IlvCoordinateSystemProperty must be used, and this class continues to work with an IlvProjectionProperty. This compatibility will be removed in the next version.
This component is packaged as a Bean and is designed to be used very easily in a JAVA development environment supporting visual programming with Beans.

See Also:

IlvProjectionProperty, IlvCoordinateSystemProperty, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JLabel

JLabel.AccessibleJLabel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

static int	CARTESIAN_MODE The mode used to display the mouse coordinates in the manager coordinate system.
static int	DMS_MODE The mode used to display the mouse coordinates in degrees, minutes and seconds.

Fields inherited from class javax.swing.JLabel

labelFor

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

IlvJCoordinateViewer()
Creates a new coordinate viewer.

Method Summary

String	getEastingLabel() Returns the prompt string to be displayed before the easting value of the mouse coordinates.
IlvGeographicCoordinateSystem	getGeographicCoordinateSystem() Returns the geographic coordinate system used by this coordinate viewer.
int	getMode() Returns the display mode of the mouse coordinates.
String	getNoProjectionMessage() Returns the message to be displayed if the coordinate viewer is used in DMS mode on a manager that has no IlvCoordinateSystem that can be converted to geographic coordinates.
String	getNorthingLabel() Returns the prompt string to be displayed before the northing value of the mouse coordinates.
IlvManagerView	getView() Returns the IlvManagerView view that controls the coordinate viewer.
boolean	isDisplayEasting() Returns true if this coordinate viewer displays the easting value of the mouse coordinates.
boolean	isDisplayNorthing() Returns true if this coordinate viewer displays the northing value of the mouse coordinates.
boolean	isVertical() Returns the orientation of the display.
void	setDisplayEasting(boolean displayEasting) Specifies whether the coordinate viewer should display the easting value of the mouse coordinates.
void	setDisplayNorthing(boolean displayNorthing) Specifies whether the coordinate viewer should display the northing value of the mouse coordinates.
void	setEastingLabel(String label) Sets the prompt string to be displayed before the easting value of the mouse coordinates.
void	setGeographicCoordinateSystem(IlvGeographicCoordinateSystem gcs) Sets a geographic coordinate system on the coordinate viewer.
void	setMode(int mode) Specifies the display mode of the mouse coordinates.
void	setNoProjectionMessage(String message) Sets the message to be displayed if the coordinate viewer is used in DMS mode on a manager that has no IlvCoordinateSystem that can be converted to georeferenced coordinates.
void	setNorthingLabel(String label) Sets the prompt string to be displayed before the northing value of the mouse coordinates.
void	setText(String str) This method has been overridden in order to handle vertical orientation.
void	setVertical(boolean vertical) Sets the orientation of the display.
void	setView(IlvManagerView view) Sets the view for which coordinates are to be displayed.

Methods inherited from class javax.swing.JLabel

checkHorizontalKey, checkVerticalKey, getAccessibleContext, getDisabledIcon, getDisplayedMnemonic, getDisplayedMnemonicIndex, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getLabelFor, getText, getUI, getUIClassID, getVerticalAlignment, getVerticalTextPosition, imageUpdate, paramString, setDisabledIcon, setDisplayedMnemonic, setDisplayedMnemonic, setDisplayedMnemonicIndex, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabelFor, setUI, setVerticalAlignment, setVerticalTextPosition, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

CARTESIAN_MODE

public static final int CARTESIAN_MODE

The mode used to display the mouse coordinates in the manager coordinate system.

See Also:

Constant Field Values

DMS_MODE

public static final int DMS_MODE

The mode used to display the mouse coordinates in degrees, minutes and seconds.

See Also:

Constant Field Values

Constructor Detail

IlvJCoordinateViewer

public IlvJCoordinateViewer()

Creates a new coordinate viewer. The instance is not active until it is associated with an IlvManagerView view.

See Also:

setView(ilog.views.IlvManagerView)

Method Detail

setNoProjectionMessage

public void setNoProjectionMessage(String message)

Sets the message to be displayed if the coordinate viewer is used in DMS mode on a manager that has no IlvCoordinateSystem that can be converted to georeferenced coordinates.

Parameters:

message - The message to be displayed.

getNoProjectionMessage

public String getNoProjectionMessage()

Returns the message to be displayed if the coordinate viewer is used in DMS mode on a manager that has no IlvCoordinateSystem that can be converted to geographic coordinates.

setEastingLabel

public void setEastingLabel(String label)

Sets the prompt string to be displayed before the easting value of the mouse coordinates. The default value is "X = ".

Parameters:

label - The easting label.

getEastingLabel

public String getEastingLabel()

Returns the prompt string to be displayed before the easting value of the mouse coordinates.

setNorthingLabel

public void setNorthingLabel(String label)

Sets the prompt string to be displayed before the northing value of the mouse coordinates. The default value is "Y = ".

Parameters:

label - The northing label.

getNorthingLabel

public String getNorthingLabel()

Returns the prompt string to be displayed before the northing value of the mouse coordinates.

Returns:

The northing label.

setDisplayEasting

public void setDisplayEasting(boolean displayEasting)

Specifies whether the coordinate viewer should display the easting value of the mouse coordinates. The coordinate viewer can be used to display either the easting value or the northing value of the coordinates, or both.

Parameters:

displayEasting - If true, easting is displayed.

isDisplayEasting

public boolean isDisplayEasting()

Returns true if this coordinate viewer displays the easting value of the mouse coordinates.

setDisplayNorthing

public void setDisplayNorthing(boolean displayNorthing)

Specifies whether the coordinate viewer should display the northing value of the mouse coordinates. The coordinate viewer can be used to display either the easting value or the northing value of the coordinates, or both.

Parameters:

displayNorthing - If true, northing is displayed.

isDisplayNorthing

public boolean isDisplayNorthing()

Returns true if this coordinate viewer displays the northing value of the mouse coordinates.

setMode

public void setMode(int mode)

Specifies the display mode of the mouse coordinates.

Parameters:

mode - The display mode.

See Also:

CARTESIAN_MODE, DMS_MODE

getMode

public int getMode()

Returns the display mode of the mouse coordinates.

Returns:

The current display mode.

setGeographicCoordinateSystem

public void setGeographicCoordinateSystem(IlvGeographicCoordinateSystem gcs)

Sets a geographic coordinate system on the coordinate viewer. In DMS_MODE, this coordinate system is used to compute the mouse location.

Parameters:

gcs - The geographic coordinate system.

Since:

JViews 5.0

getGeographicCoordinateSystem

public IlvGeographicCoordinateSystem getGeographicCoordinateSystem()

Returns the geographic coordinate system used by this coordinate viewer. The default geographic coordinate system is IlvGeographicCoordinateSystem.KERNEL.

Since:

JViews 5.0

See Also:

setGeographicCoordinateSystem(ilog.views.maps.srs.coordsys.IlvGeographicCoordinateSystem)

setView

public void setView(IlvManagerView view)

Sets the view for which coordinates are to be displayed.

getView

public IlvManagerView getView()

Returns the IlvManagerView view that controls the coordinate viewer.

setVertical

public void setVertical(boolean vertical)

Sets the orientation of the display.

Parameters:

vertical - If set to true the northing value is displayed under the easting value. If set to false, the northing value is displayed to the right of the easting value.

Since:

JViews 5.0

isVertical

public boolean isVertical()

Returns the orientation of the display.

Since:

JViews 5.0

See Also:

setVertical(boolean)

setText

public void setText(String str)

This method has been overridden in order to handle vertical orientation. If the vertical orientation is chosen, then the str String passed as argument is transformed into an HTML text to show the text on two lines.

Overrides:

setText in class JLabel

Since:

JViews 5.0