oracle.dacf.control.swing
Class ImageControl

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  oracle.dacf.control.swing.ImageControl

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.event.ActionListener, Control, ControlEnabledListener, javax.infobus.DataItemChangeListener, java.util.EventListener, java.awt.event.FocusListener, java.awt.image.ImageObserver, InfoBusManagerListener, java.awt.MenuContainer, java.io.Serializable

public class ImageControl

extends javax.swing.JPanel

implements Control, ControlEnabledListener, java.awt.event.ActionListener, InfoBusManagerListener, java.awt.event.FocusListener

Data aware ImageControl. ImageControl can be bound to ImmediateAccess items. The ImageControl treats the data stream as image (JPEG or GIF) and displays it.

Version:

PUBLIC

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

protected javax.swing.JPanel	_buttonPanel
protected java.awt.GridBagLayout	_buttonPanelLayout
protected java.awt.Dimension	_buttonPreferredSize
protected javax.swing.JButton	_clearButton
protected ControlSupport	_controlSupport
protected javax.swing.JFileChooser	_fileChooser
protected javax.swing.JScrollPane	_imageAggregate
protected javax.swing.JLabel	_imageDisplay
protected java.awt.BorderLayout	_mainPanelLayout
protected javax.swing.JButton	_newButton

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 oracle.dacf.control.Control

DEFAULT_INFOBUS_NAME, EVENT_PROPERTY_ROW, EVENT_PROPERTY_ROW_CHANGE, EVENT_PROPERTY_ROW_COUNT, EVENT_PROPERTY_VIEW_CHANGE, EVENT_PROPERTY_VIEW_REFRESHED, EVENT_PROPERTY_VIEW_SCROLLED, EXCLUDE, HIDE, SHOW

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

ImageControl()
Constructs a ImageControl.

Method Summary

protected javax.swing.JPanel	_createButtonPanel()
protected void	_enableButtons(boolean bEnable)
protected java.awt.Dimension	_getDefaultPreferredSize() get the preferred size for the image scroll pane
void	actionPerformed(java.awt.event.ActionEvent e)
void	addNavigatedListener(NavigatedListener listener) This method is a no-op that is it has no effect
void	addNavigatingListener(NavigatingListener listener) This method is a no-op that is it has no effect
void	dataItemAdded(javax.infobus.DataItemAddedEvent event) Indicates that a new item was added to the bound aggregate data item (e.g.
void	dataItemChanged(java.lang.Object oldDataItem, java.lang.Object newDataItem) Notifies the control that the bound InfoBus DataItem has changed.
void	dataItemDeleted(javax.infobus.DataItemDeletedEvent event) Indicates that an item was deleted from the bound aggregate data item (e.
void	dataItemRevoked(javax.infobus.DataItemRevokedEvent event) Indicates that the bound data item (and its sub-items, if any) has been revoked, and is temporarily unavailable.
void	dataItemValueChanged(javax.infobus.DataItemValueChangedEvent event) Indicates a changed value in the bound data item.
void	enabledChanged(boolean b)
void	focusGained(java.awt.event.FocusEvent event) This method is an implementaion side effect
void	focusLost(java.awt.event.FocusEvent event) This method is an implementaion side effect
javax.swing.JPanel	getButtonsPanel() get the panel used to display buttons
java.awt.Component	getComponent() Returns the AWT component associated with this control.
java.lang.Object	getDataItem() Returns the InfoBus DataItem this control is bound to.
java.lang.String	getDataItemName() Returns the name of the InfoBus DataItem this control is bound to.
java.lang.String	getInfoBusName() Returns the name of the InfoBus this control is connected to.
javax.swing.JLabel	getLabel() get the label control used to display the image
boolean	getReadOnly()
javax.swing.JScrollPane	getScrollPane() Scroll pane used to display the image
boolean	getShowUpdateButtons()
boolean	isFocusValidated() Determines whether focus into this control causes validation to occur.
void	processNavigatedEvent(NavigatedEvent event) This method is a no-op that is it has no effect
void	processNavigatingEvent(NavigatingEvent event) Processes a navigating event for this control.
void	releaseResources(InfoBusManagerReleaseEvent e) A signalling method used to indicate the the control should free all resources and unregister any listeners that it has registered.
void	removeNavigatedListener(NavigatedListener listener) This method is a no-op that is it has no effect
void	removeNavigatingListener(NavigatingListener listener) This method is a no-op in that it has no effect
void	rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent event) Indicates that the cursor for the bound RowsetAccess data item has changed rows.
void	setDataItemName(java.lang.String dataItemName) Sets the name of the InfoBus DataItem this control is bound to.
void	setEnabled(boolean b) An override of java.awt.Component.setEnabled.
void	setFocusValidated(boolean focusValidated) This method is a no-op that is it has no effect
void	setInfoBusName(java.lang.String infoBusName) Sets the name of the InfoBus this control is connected to.
void	setReadOnly(boolean readOnly)
void	setShowUpdateButtons(boolean bShowButtons)

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

Field Detail

_controlSupport

protected ControlSupport _controlSupport

_mainPanelLayout

protected java.awt.BorderLayout _mainPanelLayout

_buttonPanelLayout

protected java.awt.GridBagLayout _buttonPanelLayout

_imageAggregate

protected javax.swing.JScrollPane _imageAggregate

_imageDisplay

protected javax.swing.JLabel _imageDisplay

_buttonPanel

protected javax.swing.JPanel _buttonPanel

_buttonPreferredSize

protected java.awt.Dimension _buttonPreferredSize

_newButton

protected javax.swing.JButton _newButton

_clearButton

protected javax.swing.JButton _clearButton

_fileChooser

protected javax.swing.JFileChooser _fileChooser

Constructor Detail

ImageControl

public ImageControl()

Constructs a ImageControl.

Method Detail

getButtonsPanel

public javax.swing.JPanel getButtonsPanel()

get the panel used to display buttons

getLabel

public javax.swing.JLabel getLabel()

get the label control used to display the image

getScrollPane

public javax.swing.JScrollPane getScrollPane()

Scroll pane used to display the image

setShowUpdateButtons

public void setShowUpdateButtons(boolean bShowButtons)

getShowUpdateButtons

public boolean getShowUpdateButtons()

setReadOnly

public void setReadOnly(boolean readOnly)

getReadOnly

public boolean getReadOnly()

focusLost

public void focusLost(java.awt.event.FocusEvent event)

This method is an implementaion side effect

Specified by:

focusLost in interface java.awt.event.FocusListener

focusGained

public void focusGained(java.awt.event.FocusEvent event)

This method is an implementaion side effect

Specified by:

focusGained in interface java.awt.event.FocusListener

enabledChanged

public void enabledChanged(boolean b)

Specified by:

enabledChanged in interface ControlEnabledListener

releaseResources

public void releaseResources(InfoBusManagerReleaseEvent e)

Description copied from interface: InfoBusManagerListener

A signalling method used to indicate the the control should free all resources and unregister any listeners that it has registered.

Specified by:

releaseResources in interface InfoBusManagerListener

setEnabled

public void setEnabled(boolean b)

An override of java.awt.Component.setEnabled.

Specified by:

setEnabled in interface Control

Parameters:

b - boolean flag indicating whether the control is enabled

getInfoBusName

public final java.lang.String getInfoBusName()

Returns the name of the InfoBus this control is connected to.

Specified by:

getInfoBusName in interface Control

Returns:

The name of the InfoBus this control is connected to.

See Also:

Control.getInfoBusName()

setInfoBusName

public final void setInfoBusName(java.lang.String infoBusName)

Sets the name of the InfoBus this control is connected to.

By default, the control is connected to the default InfoBus, named Control.DEFAULT_INFOBUS_NAME.

If the named InfoBus does not exist, it is created automatically.

If the control is already connected to an InfoBus, it is disconnected first.

Specified by:

setInfoBusName in interface Control

Parameters:

infoBusName - The name of the InfoBus to connect to.

See Also:

Control.DEFAULT_INFOBUS_NAME, Control.setInfoBusName(java.lang.String)

getDataItemName

public final java.lang.String getDataItemName()

Returns the name of the InfoBus DataItem this control is bound to.

Specified by:

getDataItemName in interface Control

Returns:

The name of the InfoBus DataItem this control is bound to, or null if the control is unbound.

See Also:

getDataItem(), Control.getDataItemName()

setDataItemName

public final void setDataItemName(java.lang.String dataItemName)

Sets the name of the InfoBus DataItem this control is bound to.

The DataItem with the given name is searched for on the InfoBus, and if found, is bound to this control.

If the control is already bound to a DataItem, it is unbound first.

Specified by:

setDataItemName in interface Control

Parameters:

dataItemName - The name of the DataItem to bind to.

See Also:

getDataItem(), Control.setDataItemName(java.lang.String)

getDataItem

public final java.lang.Object getDataItem()

Returns the InfoBus DataItem this control is bound to.

Specified by:

getDataItem in interface Control

Returns:

The InfoBus DataItem this control is bound to, or null if the control is unbound.

See Also:

Control.getDataItem()

dataItemChanged

public final void dataItemChanged(java.lang.Object oldDataItem,
                                  java.lang.Object newDataItem)

Notifies the control that the bound InfoBus DataItem has changed.

Specified by:

dataItemChanged in interface Control

Parameters:

oldDataItem - The formerly bound DataItem (can be null).

newDataItem - The newly bound DataItem (can be null).

See Also:

Control.dataItemChanged(java.lang.Object, java.lang.Object)

getComponent

public final java.awt.Component getComponent()

Returns the AWT component associated with this control.

Specified by:

getComponent in interface Control

Returns:

The AWT component for this control.

See Also:

Control.getComponent()

isFocusValidated

public final boolean isFocusValidated()

Determines whether focus into this control causes validation to occur.

Specified by:

isFocusValidated in interface Control

Returns:

true if focus into this control causes validation to occur, false otherwise.

See Also:

Control.isFocusValidated()

setFocusValidated

public final void setFocusValidated(boolean focusValidated)

This method is a no-op that is it has no effect

Specified by:

setFocusValidated in interface Control

Parameters:

focusValidated - If true, focus into this control will cause validation to occur.

See Also:

ControlSupport.setFocusValidated(boolean)

addNavigatedListener

public final void addNavigatedListener(NavigatedListener listener)

This method is a no-op that is it has no effect

Specified by:

addNavigatedListener in interface Control

Parameters:

listener - The listener to add.

See Also:

ControlSupport.addNavigatedListener(oracle.dacf.control.NavigatedListener)

removeNavigatedListener

public final void removeNavigatedListener(NavigatedListener listener)

This method is a no-op that is it has no effect

Specified by:

removeNavigatedListener in interface Control

Parameters:

listener - The listener to remove.

See Also:

ControlSupport.removeNavigatedListener(oracle.dacf.control.NavigatedListener)

processNavigatedEvent

public final void processNavigatedEvent(NavigatedEvent event)

This method is a no-op that is it has no effect

Specified by:

processNavigatedEvent in interface Control

Parameters:

event - The navigated event.

See Also:

ControlSupport.processNavigatedEvent(oracle.dacf.control.NavigatedEvent)

addNavigatingListener

public final void addNavigatingListener(NavigatingListener listener)

This method is a no-op that is it has no effect

Specified by:

addNavigatingListener in interface Control

Parameters:

listener - The listener to add.

See Also:

ControlSupport.addNavigatedListener(oracle.dacf.control.NavigatedListener)

removeNavigatingListener

public final void removeNavigatingListener(NavigatingListener listener)

This method is a no-op in that it has no effect

Specified by:

removeNavigatingListener in interface Control

Parameters:

listener - The listener to remove.

See Also:

ControlSupport.removeNavigatedListener(oracle.dacf.control.NavigatedListener)

processNavigatingEvent

public final void processNavigatingEvent(NavigatingEvent event)
                                  throws NavigatingException

Description copied from interface: Control

Processes a navigating event for this control.

This method is for use by the NavigatedManager only.

Most controls should delegate this method to ControlSupport.

Specified by:

processNavigatingEvent in interface Control

Parameters:

event - The navigating event.

Throws:

NavigatingException - If the navigation is redirected to a different control.

See Also:

ControlSupport.processNavigatedEvent(oracle.dacf.control.NavigatedEvent)

dataItemValueChanged

public final void dataItemValueChanged(javax.infobus.DataItemValueChangedEvent event)

Indicates a changed value in the bound data item.

A reference to the data item that changed can be obtained from the event.

Specified by:

dataItemValueChanged in interface javax.infobus.DataItemChangeListener

Parameters:

event - Contains change information.

See Also:

DataItemChangeListener.dataItemValueChanged(javax.infobus.DataItemValueChangedEvent)

dataItemAdded

public final void dataItemAdded(javax.infobus.DataItemAddedEvent event)

Indicates that a new item was added to the bound aggregate data item (e.g. ArrayAccess, a JDK Collection, etc).

A reference to the data item that was added, and a reference to the one that gained it, can be obtained from the event.

Has no effect on the ImageControl.

Specified by:

dataItemAdded in interface javax.infobus.DataItemChangeListener

Parameters:

event - Contains details of the addition.

See Also:

DataItemChangeListener.dataItemAdded(javax.infobus.DataItemAddedEvent)

dataItemDeleted

public final void dataItemDeleted(javax.infobus.DataItemDeletedEvent event)

Indicates that an item was deleted from the bound aggregate data item (e. g. ArrayAccess, a JDK Collection, etc).

A reference to the data item that was deleted, and a reference to the one that lost it, can be obtained from the event.

Has no effect on the ImageControl.

Specified by:

dataItemDeleted in interface javax.infobus.DataItemChangeListener

Parameters:

event - Contains details of the deletion.

See Also:

DataItemChangeListener.dataItemDeleted(javax.infobus.DataItemDeletedEvent)

dataItemRevoked

public final void dataItemRevoked(javax.infobus.DataItemRevokedEvent event)

Indicates that the bound data item (and its sub-items, if any) has been revoked, and is temporarily unavailable.

A reference to the data item that was revoked can be obtained from the event.

Specified by:

dataItemRevoked in interface javax.infobus.DataItemChangeListener

Parameters:

event - Contains details of the revoked data.

See Also:

DataItemChangeListener.dataItemRevoked(javax.infobus.DataItemRevokedEvent)

rowsetCursorMoved

public final void rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent event)

Indicates that the cursor for the bound RowsetAccess data item has changed rows.

A reference to the rowset data item can be obtained from the event.

Specified by:

rowsetCursorMoved in interface javax.infobus.DataItemChangeListener

Parameters:

event - Contains details of the cursor move.

See Also:

DataItemChangeListener.rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent)

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Specified by:

actionPerformed in interface java.awt.event.ActionListener

_getDefaultPreferredSize

protected java.awt.Dimension _getDefaultPreferredSize()

get the preferred size for the image scroll pane

_createButtonPanel

protected javax.swing.JPanel _createButtonPanel()

_enableButtons

protected void _enableButtons(boolean bEnable)