org.ka2ddo.yaac.gui

Class LatLonEditor

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.ka2ddo.yaac.gui.LatLonEditor

All Implemented Interfaces:

java.awt.event.FocusListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.beans.PropertyChangeListener, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.AncestorListener, javax.swing.event.ChangeListener

public class LatLonEditor
extends javax.swing.JPanel
implements javax.swing.event.ChangeListener, java.beans.PropertyChangeListener, java.awt.event.FocusListener, javax.swing.event.AncestorListener

Provide a displayer/editor for a latitude or longitude value. The units that can be displayed and edited with this are set by the LatLonFormatter class's global;LatLonFormat property, and include:

• in degrees/minutes/fractional minutes and direction
• in degrees/minutes/seconds and direction
• in fractional signed degrees

Author:

Andrew Pavlin, KA2DDO

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JPanel.AccessibleJPanel

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JComponent

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
LatLonEditor(boolean isLat, double value) Construct this editor in the current format, initializing to the provided value in fractional degrees.
LatLonEditor(boolean isLat, java.lang.String value) Construct this editor in the current format, parsing the String value in the APRS-standard DDMM.MM format.

Method Summary

Modifier and Type	Method and Description
void	addChangeListener(javax.swing.event.ChangeListener l) Register a ChangeListener to be informed of alterations in this editor's value.
void	ancestorAdded(javax.swing.event.AncestorEvent event) Called when the source or one of its ancestors is made visible either by setVisible(true) being called or by its being added to the component hierarchy.
void	ancestorMoved(javax.swing.event.AncestorEvent event) Called when either the source or one of its ancestors is moved.
void	ancestorRemoved(javax.swing.event.AncestorEvent event) Called when the source or one of its ancestors is made invisible either by setVisible(false) being called or by its being remove from the component hierarchy.
void	focusGained(java.awt.event.FocusEvent e) Do not call.
void	focusLost(java.awt.event.FocusEvent e) Do not call.
double	getDoubleValue() Get the current value of this editor in fractional degrees North or East.
java.lang.String	getStringValue() Get the current value of this editor in the currently configured string format.
void	propertyChange(java.beans.PropertyChangeEvent evt) This method gets called when a bound property is changed.
void	removeChangeListener(javax.swing.event.ChangeListener l) Unregister a ChangeListener so it is no longer informed of changes within this editor.
void	setEnabled(boolean enabled) Specify whether or not this editor's value may be modified by a user.
void	setValue(double value) Set the current value in this editor from a floating-point value
void	setValue(java.lang.String value) Set the current value to be displayed in this editor.
void	stateChanged(javax.swing.event.ChangeEvent e) Do not call.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, 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, getBaseline, getBaselineResizeBehavior, 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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, 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, 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, imageUpdate, 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, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

LatLonEditor

public LatLonEditor(boolean isLat,
                    java.lang.String value)

Construct this editor in the current format, parsing the String value in the APRS-standard DDMM.MM format.

Parameters:

isLat - boolean true if this should be ranged to edit latitudes, false for longitudes

value - String value to initialize the editor to, in APRS-standard ASCII format

LatLonEditor

public LatLonEditor(boolean isLat,
                    double value)

Construct this editor in the current format, initializing to the provided value in fractional degrees.

Parameters:

isLat - boolean true if this should be ranged to edit latitudes, false for longitudes

value - double value in fractional degrees North or East (as appropriate)

Method Detail

setValue

public void setValue(java.lang.String value)

Set the current value to be displayed in this editor.

Parameters:

value - String latitude or longitude, expected to be compliant with the current format of the editor

See Also:

LatLonFormatter.getGlobalLatLonFormat()

setValue

public void setValue(double value)

Set the current value in this editor from a floating-point value

Parameters:

value - double latitude or longitude in fractional degrees North or East

getStringValue

public java.lang.String getStringValue()

Get the current value of this editor in the currently configured string format.

Returns:

formatted String of the editor's latitude or longitude value

See Also:

LatLonFormatter.getGlobalLatLonFormat()

getDoubleValue

public double getDoubleValue()

Get the current value of this editor in fractional degrees North or East.

Returns:

double fractional degrees value

setEnabled

public void setEnabled(boolean enabled)

Specify whether or not this editor's value may be modified by a user.

Overrides:

setEnabled in class javax.swing.JComponent

Parameters:

enabled - boolean true if editor's value may be changed

addChangeListener

public void addChangeListener(javax.swing.event.ChangeListener l)

Register a ChangeListener to be informed of alterations in this editor's value.

Parameters:

l - ChangeListener to register

removeChangeListener

public void removeChangeListener(javax.swing.event.ChangeListener l)

Unregister a ChangeListener so it is no longer informed of changes within this editor.

Parameters:

l - ChangeListener to unregister

stateChanged

public final void stateChanged(javax.swing.event.ChangeEvent e)

Do not call. Internal editor field listener to monitor changes to the individual sub-widgets of this editor.

Specified by:

stateChanged in interface javax.swing.event.ChangeListener

Parameters:

e - ChangeEvent identifying the specific sub-widget that was changed

focusGained

public void focusGained(java.awt.event.FocusEvent e)

Do not call. Internal editor field listener to configure sub-widgets based on user actions.

Specified by:

focusGained in interface java.awt.event.FocusListener

Parameters:

e - FocusEvent identifying the modified sub-widget

focusLost

public void focusLost(java.awt.event.FocusEvent e)

Do not call. Internal editor field listener to configure sub-widgets based on user actions.

Specified by:

focusLost in interface java.awt.event.FocusListener

Parameters:

e - FocusEvent identifying the modified sub-widget

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent evt)

This method gets called when a bound property is changed.

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

Parameters:

evt - A PropertyChangeEvent object describing the event source and the property that has changed.

ancestorAdded

public void ancestorAdded(javax.swing.event.AncestorEvent event)

Called when the source or one of its ancestors is made visible either by setVisible(true) being called or by its being added to the component hierarchy. The method is only called if the source has actually become visible. For this to be true all its parents must be visible and it must be in a hierarchy rooted at a Window

Specified by:

ancestorAdded in interface javax.swing.event.AncestorListener

ancestorRemoved

public void ancestorRemoved(javax.swing.event.AncestorEvent event)

Called when the source or one of its ancestors is made invisible either by setVisible(false) being called or by its being remove from the component hierarchy. The method is only called if the source has actually become invisible. For this to be true at least one of its parents must by invisible or it is not in a hierarchy rooted at a Window

Specified by:

ancestorRemoved in interface javax.swing.event.AncestorListener

ancestorMoved

public void ancestorMoved(javax.swing.event.AncestorEvent event)

Called when either the source or one of its ancestors is moved.

Specified by:

ancestorMoved in interface javax.swing.event.AncestorListener