DESY ACOP Beans Home

de.desy.acop.displayers
Class AcopTable

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  de.desy.acop.displayers.AcopTable

All Implemented Interfaces:

PopupManageable, CommonDisplayer, DataStateProvider, MultipleDataConsumer, MultipleDisplayer, MultipleAcopDisplayer<AcopTableParameters>, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class AcopTable
extends javax.swing.JPanel
implements MultipleAcopDisplayer<AcopTableParameters>

AcopTable is a MultipleAcopDisplayer which is inteded to show values of multi-channel arrays or spectrum arrays. The values in the table are shown in columns, where each column represent one multi channel. To connect the table to some remote property one has to add the appropriate AcopTableParameters using the method addDisplayerParameters(AcopTableParameters) or setDisplayerParameters(AcopTableParameters[]). Upon setting the parameters the AcopTable will determine the type of values that needs to be shown and created the appropriate AcopTableColumn. After a monitor on one of the multi-channels is no longer needed, that particular parameters should be removed from the table using the removeDisplayerParameters(AcopTableParameters) method.

Version:

$Id: Templates.xml,v 1.10 2004/01/13 16:17:13 jbobnar Exp $

Author:

Jaka Bobnar

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

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 de.desy.acop.displayers.tools.MultipleAcopDisplayer

DISPLAYER_PARAMETERS_PROPERTY

Fields inherited from interface com.cosylab.gui.displayers.CommonDisplayer

C_BIT_DESCRIPTIONS, C_BIT_MASK, C_COLOR, C_CONDITION_WHEN_CLEARED, C_CONDITION_WHEN_SET, C_DESCRIPTION, C_DISPLAY_NAME, C_FORMAT, C_GRAPH_MAX, C_GRAPH_MIN, C_MAXIMUM, C_MIN_STEP, C_MINIMUM, C_POSITION, C_PROPERTY_TYPE, C_SEQUENCE_LENGTH, C_UNITS

Fields inherited from interface com.cosylab.gui.displayers.DataStateProvider

DATA_STATE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

AcopTable()
Constructs new AcopTable.

Method Summary

void	addConnectionParameters(ConnectionParameters parameters) Deprecated. use addDisplayerParameters(AcopTableParameters)
void	addDisplayerParameters(AcopTableParameters parameters) Adds AcopDisplayerParameters to this displayer.
void	cleanup() Performs general cleanup of displayer resources.
ConnectionParameters[]	getConnectionParameters() Deprecated. use getDisplayerParameters()
<D extends DataConsumer> D	getConsumer(java.lang.String name, java.lang.Class<D> type) Returns data consumer of specified data consumer type and for specified string name.
DataConsumer[]	getConsumers() Returns all data consumers created by this multiple data consumer.
AbstractCustomizerPanel	getCustomizer() Returns the Customizer intance for this displayer.
DataState	getDataState() Returns data quality state.
AcopTableParameters[]	getDisplayerParameters() Returns an array of all AcopDisplayerParameters associated with this displayer.
AcopMultipleDisplayerInfoDialog	getInfoDialog() Returns the info dialog associated with this table.
int	getNumberOfRows() Returns the number of rows displayed in the table.
PopupManager	getPopupManager() Returns popup manager, which manages popup menu.
boolean	getReorderingAllowed() Returns true if reordering of columns in the table is allowed in runtime.
AcopTableParameters	getSelectedParameters() Returns the parameters that are selected in the table.
java.lang.Class<DataConsumer>[]	getSupportedConsumerTypes() Returns array of supported data consumer types, which can be used as parameter and returnned with getConsumer(String,Class) method.
ObjectTable	getTable() Returns the JTable used by this component.
boolean	isDragEnabled() Returns true if drag is enabled.
boolean	isDropEnabled() Returns true if drop is enabled.
boolean	isPopupEnabled() Return true if the popup menu is enabled or false otherwise.
boolean	isPropertiesPopupEnabled() Returns true if Properties item is enabled in the popup menu.
boolean	isSuspended() Returns true if GUI updates are suspended.
static void	main(java.lang.String[] args)
void	releaseConsumer(DataConsumer consumer) Requests frm this multiple consumer to release all resources connectet to provided single consumer.
DataSource	removeConnectionParameters(ConnectionParameters parameters) Deprecated. use removeDisplayerParameters(AcopTableParameters)
DataSource	removeDisplayerParameters(AcopTableParameters parameters) Removes a AcopDisplayerParameters from this displayer.
void	removeMouseMotionListener(java.awt.event.MouseMotionListener l)
void	resume() Resumes updates of GUI component.
void	setBackground(java.awt.Color bg)
void	setConnectionParameters(ConnectionParameters[] parameters) Sets ConnectionParameter to the displayer.
void	setDisplayerParameters(AcopTableParameters[] parameters) Sets AcopDisplayerParameters to this displayer.
void	setDragEnabled(boolean enabled) Enables/disables mouse dragging.
void	setDropEnabled(boolean enabled) Enable/disable the mouse drop.
void	setForeground(java.awt.Color fg)
void	setNumberOfRows(int numberOfRows) Sets the number of rows displayer in the table.
void	setPopupEnabled(boolean enabled) Enables or disables the popup menu.
void	setPropertiesPopupEnabled(boolean enable) Enables/disables Properties item in the popup menu.
void	setReorderingAllowed(boolean reorderingAllowed) Enables/disables reordering of the columns in the table in runtime.
void	setTransferHandler(javax.swing.TransferHandler newHandler)
void	suspend() Suspends all updates of displayer.

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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, 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, 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, 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, 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 java.lang.Object

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

Methods inherited from interface com.cosylab.gui.displayers.DataStateProvider

addPropertyChangeListener, addPropertyChangeListener, removePropertyChangeListener, removePropertyChangeListener

Constructor Detail

AcopTable

public AcopTable()

Constructs new AcopTable.

Method Detail

getSelectedParameters

public AcopTableParameters getSelectedParameters()

Returns the parameters that are selected in the table.

Returns:

the selected parameters

getTable

public ObjectTable getTable()

Returns the JTable used by this component. User can change the table as he wishes and can replace any part of the table except for the TableModel. Thi JTable is not replaceable by other instances.

Returns:

the JTable used by this component

cleanup

public void cleanup()

Description copied from interface: CommonDisplayer

Performs general cleanup of displayer resources. All by displayer issued object are not valid any more after cleanup. Displayer positions itself in initial state and DataState is changed to NOT_INITIALIZED state.

Specified by:

cleanup in interface CommonDisplayer

suspend

public void suspend()

Description copied from interface: CommonDisplayer

Suspends all updates of displayer. Displayer might receive data change updates, but does not call redraw on GUI components, which is time and CPU consuming.

Specified by:

suspend in interface CommonDisplayer

resume

public void resume()

Description copied from interface: CommonDisplayer

Resumes updates of GUI component.

Specified by:

resume in interface CommonDisplayer

See Also:

CommonDisplayer.suspend()

isSuspended

public boolean isSuspended()

Description copied from interface: CommonDisplayer

Returns true if GUI updates are suspended.

Specified by:

isSuspended in interface CommonDisplayer

Returns:

true if GUI updates are suspended

getDataState

public DataState getDataState()

Description copied from interface: DataStateProvider

Returns data quality state. This property is changed by data consumer interface. In case of multiple displayer, this state indicates integral state for all contained data consumers.

Specified by:

getDataState in interface DataStateProvider

Returns:

dynamic data quality state

getConsumer

public <D extends DataConsumer> D getConsumer(java.lang.String name,
                                              java.lang.Class<D> type)

Description copied from interface: MultipleDataConsumer

Returns data consumer of specified data consumer type and for specified string name. The organization of data is indicated with name (list, table, tree organization). Multiple consumer might interprete this by it's own preferences or abilities. The name of returned consuer must equals to provided name.

Example. Names: PS1/current, PS1/readback, PS2/current, PS2/readback migth table displayer interprete as two rows (PS1 and PS2) wtih two columns (current and readback). Tree displayer migth interprete this names as two branches with two subbranches.

Note that name is not fixed consumer property. Some displayers migth expect for name to be same as DISPLAY_NAME and is changed if display name is changed.

Specified by:

getConsumer in interface MultipleDataConsumer

Parameters:

name - organized data name

type - required data soncumer type

Returns:

newly allocated consumer for required name and type

releaseConsumer

public void releaseConsumer(DataConsumer consumer)

Description copied from interface: MultipleDataConsumer

Requests frm this multiple consumer to release all resources connectet to provided single consumer. Provided consumer must be created by this multiple consumer.

Specified by:

releaseConsumer in interface MultipleDataConsumer

Parameters:

consumer - the consumer to be released

getConsumers

public DataConsumer[] getConsumers()

Description copied from interface: MultipleDataConsumer

Returns all data consumers created by this multiple data consumer.

Specified by:

getConsumers in interface MultipleDataConsumer

Returns:

all data consumers created by this multiple data consumer

getSupportedConsumerTypes

public java.lang.Class<DataConsumer>[] getSupportedConsumerTypes()

Description copied from interface: MultipleDataConsumer

Returns array of supported data consumer types, which can be used as parameter and returnned with getConsumer(String,Class) method.

Specified by:

getSupportedConsumerTypes in interface MultipleDataConsumer

Returns:

array of supported data consumer types

addDisplayerParameters

public void addDisplayerParameters(AcopTableParameters parameters)
                            throws CommonException,
                                   java.beans.PropertyVetoException

Description copied from interface: MultipleAcopDisplayer

Adds AcopDisplayerParameters to this displayer. All previous connections are kept and this one is added to the list. Upon adding the displayer should connect to the remote point specified by this parameters and adapt the screen according to other supplied parameters.

Specified by:

addDisplayerParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Parameters:

parameters - remote connection point and screen parameters

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

addConnectionParameters

public void addConnectionParameters(ConnectionParameters parameters)
                             throws CommonException,
                                    java.beans.PropertyVetoException

Deprecated. use addDisplayerParameters(AcopTableParameters)

Description copied from interface: MultipleAcopDisplayer

Adds ConnectionParameters to the displayer. Upon adding ConnectionParameters the displayer should create a DataSource and connect it to the remote channe as specified by the parameters.

Specified by:

addConnectionParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

See Also:

MultipleAcopDisplayer.addConnectionParameters(de.desy.acop.transport.ConnectionParameters)

getDisplayerParameters

public AcopTableParameters[] getDisplayerParameters()

Description copied from interface: MultipleAcopDisplayer

Returns an array of all AcopDisplayerParameters associated with this displayer.

Specified by:

getDisplayerParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Returns:

an array of all parameters

getConnectionParameters

public ConnectionParameters[] getConnectionParameters()

Deprecated. use getDisplayerParameters()

(non-Javadoc)

Specified by:

getConnectionParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Returns:

an array of all connection parameters

See Also:

MultipleAcopDisplayer.getConnectionParameters()

removeDisplayerParameters

public DataSource removeDisplayerParameters(AcopTableParameters parameters)

Description copied from interface: MultipleAcopDisplayer

Removes a AcopDisplayerParameters from this displayer. DataSource that belongs to this parameters should be released (via AdapterFactory) and all resource associated with this parameters in the displayer should be released.

Specified by:

removeDisplayerParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Parameters:

parameters - parameters to be removed

Returns:

DataSource associated with this parameters

removeConnectionParameters

public DataSource removeConnectionParameters(ConnectionParameters parameters)

Deprecated. use removeDisplayerParameters(AcopTableParameters)

Description copied from interface: MultipleAcopDisplayer

Removes a ConnectionParameters from this displayer. DataSource that belongs to this parameters should be released (via AdapterFactory) and all resource associated with this parameters in the displayer should be released.

Specified by:

removeConnectionParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Parameters:

parameters - connection to be removed

Returns:

DataSource associated with this parameters

See Also:

MultipleAcopDisplayer.removeConnectionParameters(de.desy.acop.transport.ConnectionParameters)

setDisplayerParameters

public void setDisplayerParameters(AcopTableParameters[] parameters)
                            throws CommonException,
                                   java.beans.PropertyVetoException

Description copied from interface: MultipleAcopDisplayer

Sets AcopDisplayerParameters to this displayer. All previous connections should be terminated and then the new added. If the new array includes parameters that are already connected with this displayer, those connections do not need to be terminated. At the end of procedure the displayer should have only connections specified by the array parameters. Displayer should not allow two have two identical parameters. Parameters are identical if the DisplayerParameters.equals(Object) returns true.

Specified by:

setDisplayerParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Parameters:

parameters - remote connections points

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

setConnectionParameters

public void setConnectionParameters(ConnectionParameters[] parameters)
                             throws CommonException,
                                    java.beans.PropertyVetoException

Description copied from interface: MultipleAcopDisplayer

Sets ConnectionParameter to the displayer. All previous connections should be terminated and then the new added. If the new array includes parameters that are already connected with this displayer, those connections do not need to be terminated. At the end of procedure the displayer should have only connections specified by the array parameters.

Specified by:

setConnectionParameters in interface MultipleAcopDisplayer<AcopTableParameters>

Parameters:

parameters - remote connections points

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

getCustomizer

public AbstractCustomizerPanel getCustomizer()

Returns the Customizer intance for this displayer.

Returns:

the Customizer intance for this displayer

getPopupManager

public PopupManager getPopupManager()

Description copied from interface: PopupManageable

Returns popup manager, which manages popup menu.

Specified by:

getPopupManager in interface PopupManageable

Returns:

returns popup manager, which manages popup menu

isPopupEnabled

public boolean isPopupEnabled()

Return true if the popup menu is enabled or false otherwise.

Returns:

true if popup is enabled

setPopupEnabled

public void setPopupEnabled(boolean enabled)

Enables or disables the popup menu.

Parameters:

enabled - true if enable or false if disableds

getNumberOfRows

public int getNumberOfRows()

Returns the number of rows displayed in the table.

Returns:

setNumberOfRows

public void setNumberOfRows(int numberOfRows)

Sets the number of rows displayer in the table.

Parameters:

numberOfRows -

setTransferHandler

public void setTransferHandler(javax.swing.TransferHandler newHandler)

Overrides:

setTransferHandler in class javax.swing.JComponent

removeMouseMotionListener

public void removeMouseMotionListener(java.awt.event.MouseMotionListener l)

Overrides:

removeMouseMotionListener in class java.awt.Component

setDragEnabled

public void setDragEnabled(boolean enabled)

Enables/disables mouse dragging. Dragging can only be enabled if this component uses CosyTransferHandler.

Parameters:

enabled -

isDragEnabled

public boolean isDragEnabled()

Returns true if drag is enabled.

Returns:

true if drag is enabled

setDropEnabled

public void setDropEnabled(boolean enabled)

Enable/disable the mouse drop. Drop can only be enabled if this component uses CosyTransferHandler.

Parameters:

enabled -

isDropEnabled

public boolean isDropEnabled()

Returns true if drop is enabled.

Returns:

true if drop is enabled

getInfoDialog

public AcopMultipleDisplayerInfoDialog getInfoDialog()

Returns the info dialog associated with this table.

Returns:

the info dialog

setPropertiesPopupEnabled

public void setPropertiesPopupEnabled(boolean enable)

Enables/disables Properties item in the popup menu.

Parameters:

enable -

isPropertiesPopupEnabled

public boolean isPropertiesPopupEnabled()

Returns true if Properties item is enabled in the popup menu.

Returns:

setReorderingAllowed

public void setReorderingAllowed(boolean reorderingAllowed)

Enables/disables reordering of the columns in the table in runtime.

Parameters:

reorderingAllowed - true if reordering should be allowed

getReorderingAllowed

public boolean getReorderingAllowed()

Returns true if reordering of columns in the table is allowed in runtime.

Returns:

true if reordening is allowed

setBackground

public void setBackground(java.awt.Color bg)

Overrides:

setBackground in class javax.swing.JComponent

setForeground

public void setForeground(java.awt.Color fg)

Overrides:

setForeground in class javax.swing.JComponent

main

public static void main(java.lang.String[] args)
                 throws CommonException,
                        java.beans.PropertyVetoException

Throws:

CommonException

java.beans.PropertyVetoException