org.das2.components.propertyeditor

Class PropertyEditor

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

org.das2.components.propertyeditor.PropertyEditor

All Implemented Interfaces:

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

public class PropertyEditor
extends javax.swing.JComponent

This class implements a Hierarchical property editor

See Also:

Serialized Form

Nested Class Summary

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

Modifier and Type	Field and Description
static java.lang.Object	MULTIPLE

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
PropertyEditor(java.lang.Object bean) create a PropertyEditor for the bean.

Method Summary

Modifier and Type	Method and Description
void	addSaveAction(javax.swing.AbstractAction abstractAction) add a save button, and perform the given action.
static void	addStringEditor(java.lang.String propertyName, StringSchemeEditor editor) add a special editor for string properties with the particular name.
static void	addStringEditor(java.lang.String beanClassName, java.lang.String propertyName, StringSchemeEditor editor) add a special editor for string properties with the particular name.
static PropertyEditor	createPeersEditor(java.lang.Object leader, java.lang.Object[] peers) create a PropertyEditor when we are editing several beans at once.
void	doLayout()
javax.swing.JDialog	getDialog(java.awt.Component c) allow clients to get at the dialog so it can be positioned.
boolean	getListenForExternalChanges()
static boolean	isBean(java.lang.Object lbean) return true if the object is a Java Bean that fires property change events.
void	refresh() request a refresh, the same as if the "refresh" button was pressed.
void	setListenForExternalChanges(boolean v)
void	showDialog(java.awt.Component c)
void	showDialog(java.awt.Component c, java.lang.String title, java.awt.Image icon) display the dialog, and use the given image for the icon.
void	showModalDialog(java.awt.Component c)

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, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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 java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, 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, getAccessibleContext, 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

Field Detail

MULTIPLE

public static final java.lang.Object MULTIPLE

Constructor Detail

PropertyEditor

public PropertyEditor(java.lang.Object bean)

create a PropertyEditor for the bean.

Parameters:

bean - a java bean

Method Detail

isBean

public static boolean isBean(java.lang.Object lbean)

return true if the object is a Java Bean that fires property change events. This checks to see if listeners can be registered.

Parameters:

lbean - an object which may be a bean

Returns:

true if the object has an addPropertyChangeListener method.

setListenForExternalChanges

public void setListenForExternalChanges(boolean v)

getListenForExternalChanges

public boolean getListenForExternalChanges()

addStringEditor

public static void addStringEditor(java.lang.String propertyName,
                                   StringSchemeEditor editor)

add a special editor for string properties with the particular name.

Parameters:

propertyName - the property name, like "label"

editor - the editor to use

addStringEditor

public static void addStringEditor(java.lang.String beanClassName,
                                   java.lang.String propertyName,
                                   StringSchemeEditor editor)

add a special editor for string properties with the particular name. The beanClass argument is presently ignored, but this should be supported soon. TODO: beanClass should be supported soon

Parameters:

beanClassName - the class name containing the propertyName

propertyName - the property name, like "text"

editor - the editor to use

createPeersEditor

public static PropertyEditor createPeersEditor(java.lang.Object leader,
                                               java.lang.Object[] peers)

create a PropertyEditor when we are editing several beans at once.

Parameters:

leader - the leader bean, which is used to get settings for all components.

peers - the peers, which must all be instances of the leader's class.

Returns:

a PropertyEditor for editing several beans at once.

refresh

public void refresh()

request a refresh, the same as if the "refresh" button was pressed.

showModalDialog

public void showModalDialog(java.awt.Component c)

showDialog

public void showDialog(java.awt.Component c)

getDialog

public javax.swing.JDialog getDialog(java.awt.Component c)

allow clients to get at the dialog so it can be positioned.

Parameters:

c - parent, if initializing.

Returns:

the dialog.

showDialog

public void showDialog(java.awt.Component c,
                       java.lang.String title,
                       java.awt.Image icon)

display the dialog, and use the given image for the icon.

Parameters:

c - the parent focus

title - the dialog title.

icon - the icon branding the application.

doLayout

public void doLayout()

Overrides:

doLayout in class java.awt.Container

addSaveAction

public void addSaveAction(javax.swing.AbstractAction abstractAction)

add a save button, and perform the given action.

Parameters:

abstractAction - the action to perform.