org.geotools.gui.swing.referencing
Class AuthorityCodesComboBox

Object
  extended by Component
      extended by Container
          extended by JComponent
              extended by AuthorityCodesComboBox
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable

public class AuthorityCodesComboBox
extends JComponent

A combox box for selecting a coordinate reference system from a list. This component also provides a search button (for filtering the CRS name that contain the specified keywords) and a info button displaying the CRS properties sheet.

Since:
2.3
Author:
Martin Desruisseaux (IRD)
See Also:
Serialized Form
Module:

Nested Class Summary
 
Nested classes/interfaces inherited from class JComponent
JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class 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 Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
AuthorityCodesComboBox()
          Creates a CRS chooser backed by the EPSG authority factory.
AuthorityCodesComboBox(AuthorityFactory factory)
          Creates a CRS chooser backed by the specified authority factory.
AuthorityCodesComboBox(AuthorityFactory factory, Class type)
          Creates a CRS chooser backed by the specified authority factory.
AuthorityCodesComboBox(String authority)
          Creates a CRS chooser backed by the specified authority factory.
 
Method Summary
 void filter(String keywords)
          Display only the CRS name that contains the specified keywords.
 String getAuthority()
          Returns the authority name.
 String getSelectedCode()
          Returns the code for the selected object, or null if none.
 IdentifiedObject getSelectedItem()
          Returns the selected object, usually as a CoordinateReferenceSystem.
static void main(String[] args)
          Display the chooser.
 void showProperties()
          Display information about the currently selected item in a separated window.
 
Methods inherited from class JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, 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, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, 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, updateUI
 
Methods inherited from class 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 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, 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, transferFocusUpCycle
 
Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AuthorityCodesComboBox

public AuthorityCodesComboBox()
                       throws FactoryRegistryException,
                              FactoryException
Creates a CRS chooser backed by the EPSG authority factory.

Throws:
FactoryRegistryException - if no EPSG authority factory has been found.
FactoryException - if the factory can't provide CRS codes.

AuthorityCodesComboBox

public AuthorityCodesComboBox(String authority)
                       throws FactoryRegistryException,
                              FactoryException
Creates a CRS chooser backed by the specified authority factory.

Parameters:
authority - The authority identifier (e.g. "EPSG").
Throws:
FactoryRegistryException - if no authority factory has been found.
FactoryException - if the factory can't provide CRS codes.
Since:
2.4

AuthorityCodesComboBox

public AuthorityCodesComboBox(AuthorityFactory factory)
                       throws FactoryException
Creates a CRS chooser backed by the specified authority factory.

Parameters:
factory - The authority factory responsible for creating objects from a list of codes.
Throws:
FactoryException - if the factory can't provide CRS codes.

AuthorityCodesComboBox

public AuthorityCodesComboBox(AuthorityFactory factory,
                              Class type)
                       throws FactoryException
Creates a CRS chooser backed by the specified authority factory.

Parameters:
factory - The authority factory responsible for creating objects from a list of codes.
type - The type of CRS object to includes in the list.
Throws:
FactoryException - if the factory can't provide CRS codes.
Method Detail

getAuthority

public String getAuthority()
Returns the authority name. Useful for providing a window title for example.


getSelectedCode

public String getSelectedCode()
Returns the code for the selected object, or null if none.


getSelectedItem

public IdentifiedObject getSelectedItem()
                                 throws FactoryException
Returns the selected object, usually as a CoordinateReferenceSystem.

Throws:
FactoryException - if the factory can't create the selected object.

showProperties

public void showProperties()
Display information about the currently selected item in a separated window. The default implementation show the Well Know Text.


filter

public void filter(String keywords)
Display only the CRS name that contains the specified keywords. The keywords argument is a space-separated list, usually provided by the user after he pressed the "Search" button.

Parameters:
keywords - space-separated list of keywords to look for.

main

public static void main(String[] args)
                 throws FactoryRegistryException,
                        FactoryException
Display the chooser. This method is provided mainly for testing purpose.

If the -prototype argument is provided on the command line, then this method display the longuest CRS name found in the database. This is useful for setting the combo box prototype display value.

Throws:
FactoryRegistryException - if no EPSG authority factory has been found.
FactoryException - if the factory can't provide CRS codes.


Copyright © 1996-2009 Geotools. All Rights Reserved.