org.geotools.gui.swing.referencing
Class AuthorityCodesComboBox

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              org.geotools.gui.swing.referencing.AuthorityCodesComboBox

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

public class AuthorityCodesComboBox

extends javax.swing.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

Version:

$Id: AuthorityCodesComboBox.java 17934 2006-02-09 09:08:30Z desruisseaux $

Author:

Martin Desruisseaux

See Also:

Serialized Form

Nested Class Summary

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 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

AuthorityCodesComboBox()
Creates a CRS chooser backed by the EPSG authority factory.

AuthorityCodesComboBox(org.opengis.referencing.AuthorityFactory factory)
Creates a CRS chooser backed by the specified authority factory.

AuthorityCodesComboBox(org.opengis.referencing.AuthorityFactory factory, java.lang.Class type)
Creates a CRS chooser backed by the specified authority factory.

Method Summary

void	filter(java.lang.String keywords) Display only the CRS name that contains the specified keywords.
java.lang.String	getAuthority() Returns the authority name.
java.lang.String	getSelectedCode() Returns the code for the selected object, or if none.
org.opengis.referencing.IdentifiedObject	getSelectedItem() Returns the selected object, usually as a CoordinateReferenceSystem.
static void	main(java.lang.String[] args) Display the chooser.
void	showProperties() Display information about the currently selected item in a separated window.

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, getAccessibleContext, 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, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, 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, updateUI

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

AuthorityCodesComboBox

public AuthorityCodesComboBox()
                       throws FactoryRegistryException,
                              org.opengis.referencing.FactoryException

Creates a CRS chooser backed by the EPSG authority factory.

Throws:

FactoryRegistryException - if no EPSG authority factory has been found.

org.opengis.referencing.FactoryException - if the factory can't provide CRS codes.

AuthorityCodesComboBox

public AuthorityCodesComboBox(org.opengis.referencing.AuthorityFactory factory)
                       throws org.opengis.referencing.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:

org.opengis.referencing.FactoryException - if the factory can't provide CRS codes.

AuthorityCodesComboBox

public AuthorityCodesComboBox(org.opengis.referencing.AuthorityFactory factory,
                              java.lang.Class type)
                       throws org.opengis.referencing.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:

org.opengis.referencing.FactoryException - if the factory can't provide CRS codes.

Method Detail

getAuthority

public java.lang.String getAuthority()

Returns the authority name. Useful for providing a window title for example.

getSelectedCode

public java.lang.String getSelectedCode()

Returns the code for the selected object, or if none.

getSelectedItem

public org.opengis.referencing.IdentifiedObject getSelectedItem()
                                                         throws org.opengis.referencing.FactoryException

Returns the selected object, usually as a CoordinateReferenceSystem.

Throws:

org.opengis.referencing.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(java.lang.String keywords)

Display only the CRS name that contains the specified keywords. The 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(java.lang.String[] args)
                 throws FactoryRegistryException,
                        org.opengis.referencing.FactoryException

Display the chooser. This method is provided mainly for testing purpose.

If the 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.

org.opengis.referencing.FactoryException - if the factory can't provide CRS codes.