oracle.dacf.control.swing
Class ComboBoxControl

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JComboBox
                  oracle.dacf.control.swing.ComboBoxControl

All Implemented Interfaces:

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

public class ComboBoxControl

extends javax.swing.JComboBox

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

ComboBoxControl is a data aware combo box. It is comprised of a textfield and a listbox. The textfield and listbox can be bound to different data items. ComboBoxControl, by default is used to update values. The _dataItemUsageMode property is set to FOR_UPDATE and the the ComboBoxControl updates the attribute that is bound via the _dataItemNameForUpdate property.

The ComboBoxControl can also be used for navigation like a ListControl. When _dataItemUsageMode is set to FOR_NAVIGATION the ComboBoxControl ceases to update and is used instead to navigate through the values that are bound via the _dataItemName property.

Update mode : ************* The ComboBoxControl, when used in Update mode, assumes a master detail relationship. The following three column attributes have to be defined a) dataItemNameForUpdate - this specifies which column in the detail table should be updated b) listKeyDataItemName - this specifies which column in the master table should be displayed in the popup list of the the combo box. c) listValueDataItemName - this specifies which column 'value' in the master table should be used for update. Consider DEPT (master), EMP (detail) tables and combo box used for updating the deptno field in the EMP table. The attributes, for update should be set in the following way dataItemNameForUpdate - DEPTNO column in EMP listKeyDataItemName - DNAME column in DEPT listValueDataItemName - DEPTNO column in DEPT When the ComboBox is setup this way, the popup list will display the department names. When an update is done (changing selection in combo) the department name string is used as lookup string in the DNAME column of DEPT and the corresponding value in DEPTNO (from DEPT )is used to update the DEPTNO in EMP. // sample usage comboBox.setListKeyDataItemName("infobus:/oracle/Session1/DeptView/Dname"); comboBox.setListValueDataItemName("infobus:/oracle/Session1/DeptView/Deptno"); comboBox.setDataItemNameForUpdate("infobus:/oracle/Session1/EmpView/Deptno"); Navigate Mode : ***************** The listKeyDataItemName is the only property that needs to be set. The popup list is populate with values in this column. // sample usage comboBox.setListKeyDataItemName("infobus:/oracle/Session1/DeptView/Dname");

Version:

PUBLIC

See Also:

Control, Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JComboBox

javax.swing.JComboBox.AccessibleJComboBox, javax.swing.JComboBox.KeySelectionManager

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

actionCommand, dataModel, editor, isEditable, keySelectionManager, lightWeightPopupEnabled, maximumRowCount, renderer, selectedItemReminder

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

FOR_NAVIGATION, FOR_UPDATE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

ComboBoxControl()
Constructs a default ComboBoxControl.

ComboBoxControl(javax.swing.ComboBoxModel aModel)
Creates a ComboBoxControl that takes its items from an existing ComboBoxDataModel.

ComboBoxControl(java.lang.Object[] items)
Creates a ComboBoxControl that contains the elements in the specified array.

ComboBoxControl(java.util.Vector items)
Creates a ComboBoxControl that contains the elements in the specified Vector.

Method Summary

void	addNavigatedListener(NavigatedListener listener) Adds a navigated listener to this control.
void	addNavigatingListener(NavigatingListener listener) Adds a navigating listener to this control.
void	contentsChanged(javax.swing.event.ListDataEvent e) A notification that the contents changed
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 e) A notification that this control gained focus This method is an implementation side effect
void	focusLost(java.awt.event.FocusEvent e) A notification that this control lost focus This method is an implementation side effect
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() Deprecated. use getListKeyDataItemName
java.lang.String	getDataItemNameForUpdate() Returns the name of the InfoBus DataItem this control is bound to.
int	getDataItemUsageMode() get the mode in which the combobox is confiured to work - navigation or update
java.lang.String	getInfoBusName() Returns the name of the InfoBus this control is connected to.
java.lang.String	getListKeyDataItemName() get the list key data item name return dataItemName for the values displayed in the popup list
java.lang.String	getListValueDataItemName() get the list value data item name return dataItemName for the update value
java.lang.String	getMode() get the mode in which this ComboBox is configured to work
static java.lang.String	getName(java.lang.Object newDataItem)
ControlSupport	getUpdateControlSupport() get the control support object used for update's
boolean	isFocusValidated() Determines whether focus into this control causes validation to occur.
void	processNavigatedEvent(NavigatedEvent event) Processes a navigated event for this control.
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) Removes a navigated listener from this control.
void	removeNavigatingListener(NavigatingListener listener) Removes a previusly added navigating listener
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) Deprecated. use setListKeyDataItemName
void	setDataItemNameForUpdate(java.lang.String dataItemName) Sets the name of the InfoBus DataItem this control is bound to.
void	setDataItemUsageMode(int usage) Determines whether the values that are selected in the ListBox are used to navigate through the dataItem
void	setEditable(boolean editable) Determines whether new values can be entered in the textfield or not
void	setEnabled(boolean b) An override of java.awt.Component.setEnabled.
void	setFocusValidated(boolean focusValidated) Sets whether focus into this control causes validation to occur.
void	setInfoBusName(java.lang.String infoBusName) Sets the name of the InfoBus this control is connected to.
void	setListKeyDataItemName(java.lang.String dataItemName) specify the list key data item name This data item will be used to display the values in the popup list in the update mode and navigate mode
void	setListValueDataItemName(java.lang.String dataItemName) specify the list value data item name This data item will be used for update.

Methods inherited from class javax.swing.JComboBox

actionPerformed, addActionListener, addItem, addItemListener, addPopupMenuListener, configureEditor, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultKeySelectionManager, fireActionEvent, fireItemStateChanged, firePopupMenuCanceled, firePopupMenuWillBecomeInvisible, firePopupMenuWillBecomeVisible, getAccessibleContext, getAction, getActionCommand, getActionListeners, getEditor, getItemAt, getItemCount, getItemListeners, getKeySelectionManager, getMaximumRowCount, getModel, getPopupMenuListeners, getPrototypeDisplayValue, getRenderer, getSelectedIndex, getSelectedItem, getSelectedObjects, getUI, getUIClassID, hidePopup, insertItemAt, installAncestorListener, intervalAdded, intervalRemoved, isEditable, isLightWeightPopupEnabled, isPopupVisible, paramString, processKeyEvent, removeActionListener, removeAllItems, removeItem, removeItemAt, removeItemListener, removePopupMenuListener, selectedItemChanged, selectWithKeyChar, setAction, setActionCommand, setEditor, setKeySelectionManager, setLightWeightPopupEnabled, setMaximumRowCount, setModel, setPopupVisible, setPrototypeDisplayValue, setRenderer, setSelectedIndex, setSelectedItem, setUI, showPopup, 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, 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

Constructor Detail

ComboBoxControl

public ComboBoxControl()

Constructs a default ComboBoxControl. The renderer properties of the constructed instance is set to ListCellPainter

ComboBoxControl

public ComboBoxControl(java.util.Vector items)

Creates a ComboBoxControl that contains the elements in the specified Vector.

Parameters:

items - elements picked from this vector

ComboBoxControl

public ComboBoxControl(java.lang.Object[] items)

Creates a ComboBoxControl that contains the elements in the specified array.

Parameters:

items - elements picked from this array

ComboBoxControl

public ComboBoxControl(javax.swing.ComboBoxModel aModel)

Creates a ComboBoxControl that takes its items from an existing ComboBoxDataModel.

Parameters:

aModel - the ComboBoxModel that provides the displayed list of items

Method Detail

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

setDataItemName

public void setDataItemName(java.lang.String dataItemName)

Deprecated. use setListKeyDataItemName

Sets the dataItemName to be used for populating the list of choices for the combobox

Specified by:

setDataItemName in interface Control

Parameters:

dataItemName - Fully qaulified name of the name of the dataitem

See Also:

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

getDataItemName

public java.lang.String getDataItemName()

Deprecated. use getListKeyDataItemName

Get the name of the dataItem being used for populating the list

Specified by:

getDataItemName in interface Control

Returns:

dataItemName property

See Also:

Control.getDataItem(), ControlSupport.getDataItemName()

setListKeyDataItemName

public void setListKeyDataItemName(java.lang.String dataItemName)

specify the list key data item name This data item will be used to display the values in the popup list in the update mode and navigate mode

Parameters:

dataItemName - for the values displayed in the popup list

getListKeyDataItemName

public java.lang.String getListKeyDataItemName()

get the list key data item name return dataItemName for the values displayed in the popup list

setListValueDataItemName

public void setListValueDataItemName(java.lang.String dataItemName)

specify the list value data item name This data item will be used for update. This property is used only in the update mode

Parameters:

dataItemName - for update

getListValueDataItemName

public java.lang.String getListValueDataItemName()

get the list value data item name return dataItemName for the update value

getMode

public java.lang.String getMode()

get the mode in which this ComboBox is configured to work

Returns:

a String indicating whenther the control is configured for navigation or update

getName

public static java.lang.String getName(java.lang.Object newDataItem)

setDataItemUsageMode

public void setDataItemUsageMode(int usage)

Determines whether the values that are selected in the ListBox are used to navigate through the dataItem

Specified by:

setDataItemUsageMode in interface DualBindingControl

getDataItemUsageMode

public int getDataItemUsageMode()

get the mode in which the combobox is confiured to work - navigation or update

Specified by:

getDataItemUsageMode in interface DualBindingControl

Returns:

the mode in which the combobox is configured to work

setEditable

public void setEditable(boolean editable)

Determines whether new values can be entered in the textfield or not

If editable is true installs a ComboBoxDataItemEditor as the editor for editing.

Parameters:

editable - if true then new values can be entered in the textfield else the value must be picked from the listbox

contentsChanged

public void contentsChanged(javax.swing.event.ListDataEvent e)

A notification that the contents changed

Specified by:

contentsChanged in interface javax.swing.event.ListDataListener

Parameters:

e - event object describing the event

focusGained

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

A notification that this control gained focus This method is an implementation side effect

Specified by:

focusGained in interface java.awt.event.FocusListener

Parameters:

e - focus gain event

focusLost

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

A notification that this control lost focus This method is an implementation side effect

Specified by:

focusLost in interface java.awt.event.FocusListener

Parameters:

e - focus lost event

enabledChanged

public void enabledChanged(boolean b)

Specified by:

enabledChanged in interface ControlEnabledListener

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.

Most controls should delegate this method to ControlSupport.

Specified by:

getInfoBusName in interface Control

Returns:

The name of the InfoBus this control is connected to.

See Also:

ControlSupport.getInfoBusName()

setInfoBusName

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

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

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

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

Most controls should delegate this method to ControlSupport.

Specified by:

setInfoBusName in interface Control

Parameters:

infoBusName - The name of the InfoBus to connect to.

See Also:

ControlSupport.setInfoBusName(java.lang.String)

getDataItemNameForUpdate

public final java.lang.String getDataItemNameForUpdate()

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

Most controls should delegate this method to ControlSupport.

Specified by:

getDataItemNameForUpdate in interface DualBindingControl

Returns:

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

See Also:

getDataItem(), ControlSupport.getDataItemName()

setDataItemNameForUpdate

public final void setDataItemNameForUpdate(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.

Most controls should delegate this method to ControlSupport.

Specified by:

setDataItemNameForUpdate in interface DualBindingControl

Parameters:

dataItemName - The name of the DataItem to bind to.

See Also:

getDataItem(), ControlSupport.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:

ControlSupport.getDataItem()

dataItemChanged

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

Notifies the control that the bound InfoBus DataItem has changed.

The control can safely ignore this notification.

Specified by:

dataItemChanged in interface Control

Parameters:

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

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

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.

isFocusValidated

public final boolean isFocusValidated()

Determines whether focus into this control causes validation to occur.

Most controls should delegate this method to ControlSupport.

Specified by:

isFocusValidated in interface Control

Returns:

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

See Also:

ControlSupport.isFocusValidated()

setFocusValidated

public final void setFocusValidated(boolean focusValidated)

Sets whether focus into this control causes validation to occur.

Delegates to ControlSupport.

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)

Adds a navigated listener to this control.

The listener will be notified of NavigateIn and NavigateOut events.

Delegates to ControlSupport.

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)

Removes a navigated listener from this control.

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)

Processes a navigated event for this control.

This method is for use by the NavigationManager only.

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)

Adds a navigating listener to this control.

The listener will be notified of NavigatingEvents.

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)

Removes a previusly added navigating listener

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

Processes a navigating event for this control.

This method is for use by the NavigationManager only.

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.

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.

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

getUpdateControlSupport

public final ControlSupport getUpdateControlSupport()

get the control support object used for update's