org.jeospace.ui.swing.components
Class LatitudeSpinner

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  org.jeospace.ui.swing.components.JeospaceComp
                      org.jeospace.ui.swing.components.LatitudeSpinner

All Implemented Interfaces:

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

public class LatitudeSpinner

extends JeospaceComp

implements javax.swing.event.ChangeListener

A compound widget for manipulating Latitude values.

The style of the angle displayed is determined by the AngleFormat object that the control is instantiated with. The angle object may be a multi-field object depending on the formatting specified. Individual fields may be manipulated by selecting the field text.

Version:

$Revision: 1.1 $

Author:

Rex Melton

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

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

Field Summary

Fields inherited from class org.jeospace.ui.swing.components.JeospaceComp

listenerArray, NULL_LISTENER_ARRAY

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 java.awt.image.ImageObserver

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

Constructor Summary

LatitudeSpinner()
Constructor.

LatitudeSpinner(Latitude initial)
Constructor.

LatitudeSpinner(Latitude initial, AngleFormat formatter)
Constructor.

Method Summary

void	addRollListener(Rollable listener) Add a listener for Rollable events
Latitude	getLatitude() Return the Latitude object that this control is acting on.
Angle	getMaximum() Return the maximum value.
Angle	getMinimum() Return the minimum value.
static void	main(java.lang.String[] arg) Create a JFrame with a LatitudeSpinner inside.
void	refresh() Reset the formatted text field, without changing the spider parameters.
void	removeRollListener(Rollable listener) Remove a listener for Rollable events
void	setAngleFormat(AngleFormat formatter) Set the formatter.
void	setLatitude(Latitude newAngle) Set the Latitude object to be manipulated by the control.
void	setMaximum(Angle maximum) Set the maximum value the Latitude object in this control may have.
void	setMinimum(Angle minimum) Set the minimum value the Latitude object in this control may have.
void	stateChanged(javax.swing.event.ChangeEvent ce) Invoked when the spinner model changes value

Methods inherited from class org.jeospace.ui.swing.components.JeospaceComp

addValueChangeListener, fireValueChangeEvent, removeValueChangeListener

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, 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, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, 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, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, 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

Constructor Detail

LatitudeSpinner

public LatitudeSpinner()

Constructor.

There will be no initial limits imposed on the value of the Latitude by this control. However, latitudes by default are limited to a range of +/- 90 degrees. An AngleFormat object with the style AngleFormatStyle.ANGLE will be created as the formatter.

LatitudeSpinner

public LatitudeSpinner(Latitude initial)

Constructor.

There will be no initial limits imposed on the value of the Latitude by this control. However, latitudes by default are limited to a range of +/- 90 degrees. An AngleFormat object with the style AngleFormatStyle.ANGLE will be created as the formatter.

Parameters:

initial - - The initial Latitude object that this control will act on. If null, a new zero value Angle object will be created.

LatitudeSpinner

public LatitudeSpinner(Latitude initial,
                       AngleFormat formatter)

Constructor.

There will be no initial limits imposed on the value of the Latitude by this control. However, latitudes by default are limited to a range of +/- 90 degrees.

Parameters:

initial - - The initial Latitude object that this control will act on. If null, a new zero value Latitude object will be created.

formatter - - The AngleFormat object that will format the Latitude object for display. If null, an AngleFormat object with the style AngleFormatStyle.ANGLE will be created.

Method Detail

stateChanged

public void stateChanged(javax.swing.event.ChangeEvent ce)

Invoked when the spinner model changes value

Specified by:

stateChanged in interface javax.swing.event.ChangeListener

Parameters:

ce - the ChangeEvent

addRollListener

public void addRollListener(Rollable listener)

Add a listener for Rollable events

Parameters:

listener - the listener

removeRollListener

public void removeRollListener(Rollable listener)

Remove a listener for Rollable events

Parameters:

listener - the listener

setAngleFormat

public void setAngleFormat(AngleFormat formatter)

Set the formatter. If a value of null is supplied as the argument, an AngleFormat object with the style AngleFormatStyle.ANGLE will be used.

Parameters:

formatter - - The AngleFormat object

setLatitude

public void setLatitude(Latitude newAngle)

Set the Latitude object to be manipulated by the control. If the argument is null, the control's display will be cleared and the spinner functionality disabled. If the argument is non-null and the new value is less than the minimum or greater than the maximum, then the Angle object will be set to the minimum or maximum value (respectively).

Parameters:

newAngle - - The new Latitude object

getLatitude

public Latitude getLatitude()

Return the Latitude object that this control is acting on.

Returns:

the Angle object. null will be returned if the Latitude has been set to null.

setMinimum

public void setMinimum(Angle minimum)

Set the minimum value the Latitude object in this control may have. Note that latitudes by default are limited to a range of +/- 90 degrees. Therefore, setting a minimum value beyond this range will have no effect.

Parameters:

minimum - - An Angle object containing the minimum value for the Angle in this control. A value of null will set the minumum value for the control to it's greatest negative value.

getMinimum

public Angle getMinimum()

Return the minimum value. The returned value reflects the setting, not the default limits of a Latitude object.

Returns:

the minimum value

setMaximum

public void setMaximum(Angle maximum)

Set the maximum value the Latitude object in this control may have. Note that latitudes by default are limited to a range of +/-90 degrees. Therefore, setting a maximum value beyond this range will have no effect.

Parameters:

maximum - - An Angle object containing the maximum value for the Angle in this control. A value of null will set the maximum value for the control to it's greatest positive value.

getMaximum

public Angle getMaximum()

Return the maximum value. The returned value reflects the setting, not the default limits of a Latitude object.

Returns:

the maximum value

refresh

public void refresh()

Reset the formatted text field, without changing the spider parameters. Used when the Latitude object has been modified external to this widget and the displayed text should be updated.

main

public static void main(java.lang.String[] arg)

Create a JFrame with a LatitudeSpinner inside. Can be used for testing.

Parameters:

arg - - Command line arguments, none necessary.