|
Oracle Data-aware Controls Reference | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
oracle.dacf.control.swing.ListControl
ListControl is a data aware listbox. In it's default configuration a ListControl provides a read only view of all the values of a column in a ScrollableRowsetAccess
ListControl is a composite control comprising of a JList and a JScrollPane.
ListControl, by default is used as a navigational control. The _dataItemUsageMode property is set to FOR_NAVIGATION and the the ListControl navigates through the rowset that is associated with the attribute that is bound via the _dataItemName property.
The ListControl can also be used to update values like a ComboBoxControl. When _dataItemUsageMode is set to FOR_UPDATE the ListBox ceases to navigate and is used instead to update the value that is bound via the _dataItemNameForUpdate property.
Using the _updateControlSupport we maintain a binding to the ImmediateAccess you want to update. In that way our model always contains the current ImmediateAccess value.
When a value is chosen via the ListControl and we are in an updatable state that value is updated.
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 |
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 | |
ListControl()
Constructs a default ListControl. |
|
ListControl(javax.swing.ListModel dataModel)
Constructs a ListControl that displays the elements in the specified model. |
|
ListControl(java.lang.Object[] listData)
Constructs a ListControl that displays the elements in the specified array. |
|
ListControl(java.util.Vector listData)
Constructs a ListControl that displays 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. |
protected javax.swing.ListSelectionModel |
createSelectionModel()
Called by the constructor to create the selection model to be used by this control. |
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)
|
javax.swing.ListCellRenderer |
getCellRenderer()
|
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 |
getDataItemNameForUpdate()
Get the name of the dataItem being used for updating the values in the the list |
int |
getDataItemUsageMode()
get the data item usage mode. |
int |
getFixedCellHeight()
Gets the fixedCellHeight of underlying JList |
int |
getFixedCellWidth()
Gets the fixedCellWidth of underlying JList |
java.lang.String |
getInfoBusName()
Returns the name of the InfoBus this control is connected to. |
javax.swing.JList |
getList()
Gets the underlying JList used by this control. |
java.lang.String |
getMode()
|
javax.swing.ListModel |
getModel()
|
java.lang.String |
getName(java.lang.Object newDataItem)
get value of the dataitem as a string |
java.lang.Object |
getPrototypeCellValue()
|
int |
getSelectedIndex()
|
int[] |
getSelectedIndices()
|
java.awt.Color |
getSelectionBackground()
Gets the background color used for painting the selected cell |
java.awt.Color |
getSelectionForeground()
Gets the foreground color used for painting the selected cell |
int |
getSelectionMode()
|
javax.swing.ListSelectionModel |
getSelectionModel()
|
boolean |
getValueIsAdjusting()
|
int |
getVisibleRowCount()
Gets the visibleRowCount property of underlying JList |
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 |
setCellRenderer(javax.swing.ListCellRenderer cellRenderer)
|
void |
setDataItemName(java.lang.String dataItemName)
Sets the name of the InfoBus DataItem this control is bound to. |
void |
setDataItemNameForUpdate(java.lang.String valueDataItemName)
Sets the dataItemName to be used for updating the values via the ListBox |
void |
setDataItemUsageMode(int usage)
Determines whether the values that are selected in the ListBox are used to navigate through the dataItem |
void |
setEnabled(boolean b)
An override of java.awt.Component.setEnabled. |
void |
setFixedCellHeight(int fixedCellHeight)
Sets the fixedCellHeight of underlying JList |
void |
setFixedCellWidth(int fixedCellWidth)
Sets the fixedCellWidth of underlying JList |
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 |
setListData(java.lang.Object[] listData)
Delegates to underlying JList |
void |
setModel(javax.swing.ListModel model)
|
void |
setOpaque(boolean isOpaque)
|
void |
setPrototypeCellValue(java.lang.Object prototypeCellValue)
|
void |
setSelectedIndex(int index)
Moves the selected index to the specfied index. |
void |
setSelectedIndices(int[] indices)
|
void |
setSelectionBackground(java.awt.Color selectionBackground)
Sets the background color used for painting the selected cell |
void |
setSelectionForeground(java.awt.Color selectionForeground)
Sets the foreground color used for painting the selected cell |
void |
setSelectionMode(int selectionMode)
|
void |
setSelectionModel(javax.swing.ListSelectionModel selectionModel)
|
void |
setToolTipText(java.lang.String text)
|
void |
setValueIsAdjusting(boolean b)
|
void |
setVisibleRowCount(int rows)
Sets the visibleRowCount property of underlying JList |
java.lang.String |
toString()
String represntation of this object |
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, setPreferredSize, setRequestFocusEnabled, 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, transferFocus, transferFocusUpCycle |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public ListControl()
public ListControl(java.util.Vector listData)
listData
- vector to be displayedpublic ListControl(java.lang.Object[] listData)
listData
- array to be displayedpublic ListControl(javax.swing.ListModel dataModel)
dataModel
- data model to be displayedMethod Detail |
public void setListData(java.lang.Object[] listData)
JList
public final javax.swing.JList getList()
public void releaseResources(InfoBusManagerReleaseEvent e)
InfoBusManagerListener
releaseResources
in interface InfoBusManagerListener
public void enabledChanged(boolean b)
enabledChanged
in interface ControlEnabledListener
public void setEnabled(boolean b)
setEnabled
in interface Control
b
- boolean flag indicating whether the control is enabledpublic final java.lang.String getInfoBusName()
Most controls should delegate this method to ControlSupport.
getInfoBusName
in interface Control
ControlSupport.getInfoBusName()
public final void setInfoBusName(java.lang.String infoBusName)
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.
setInfoBusName
in interface Control
infoBusName
- The name of the InfoBus to connect to.ControlSupport.setInfoBusName(java.lang.String)
public final java.lang.String getDataItemName()
Most controls should delegate this method to ControlSupport.
getDataItemName
in interface Control
getDataItem()
,
ControlSupport.getDataItemName()
public final void setDataItemName(java.lang.String dataItemName)
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.
setDataItemName
in interface Control
dataItemName
- The name of the DataItem to bind to.getDataItem()
,
ControlSupport.setDataItemName(java.lang.String)
public final java.lang.Object getDataItem()
getDataItem
in interface Control
ControlSupport.getDataItem()
public final void dataItemChanged(java.lang.Object oldDataItem, java.lang.Object newDataItem)
The control can safely ignore this notification.
dataItemChanged
in interface Control
oldDataItem
- The formerly bound DataItem (can be null).newDataItem
- The newly bound DataItem (can be null).public final java.awt.Component getComponent()
getComponent
in interface Control
public final boolean isFocusValidated()
Most controls should delegate this method to ControlSupport.
isFocusValidated
in interface Control
ControlSupport.isFocusValidated()
public final void setFocusValidated(boolean focusValidated)
Delegates to ControlSupport.
setFocusValidated
in interface Control
focusValidated
- If true, focus into this control will
cause validation to occur.ControlSupport.setFocusValidated(boolean)
public final void addNavigatedListener(NavigatedListener listener)
The listener will be notified of NavigateIn and NavigateOut events.
Delegates to ControlSupport.
addNavigatedListener
in interface Control
listener
- The listener to add.ControlSupport.addNavigatedListener(oracle.dacf.control.NavigatedListener)
public final void removeNavigatedListener(NavigatedListener listener)
removeNavigatedListener
in interface Control
listener
- The listener to remove.ControlSupport.removeNavigatedListener(oracle.dacf.control.NavigatedListener)
public final void processNavigatedEvent(NavigatedEvent event)
This method is for use by the NavigationManager only.
processNavigatedEvent
in interface Control
event
- The navigated event.ControlSupport.processNavigatedEvent(oracle.dacf.control.NavigatedEvent)
public final void addNavigatingListener(NavigatingListener listener)
The listener will be notified of NavigatingEvents.
addNavigatingListener
in interface Control
listener
- The listener to add.ControlSupport.addNavigatedListener(oracle.dacf.control.NavigatedListener)
public final void removeNavigatingListener(NavigatingListener listener)
removeNavigatingListener
in interface Control
listener
- The listener to remove.ControlSupport.removeNavigatedListener(oracle.dacf.control.NavigatedListener)
public final void processNavigatingEvent(NavigatingEvent event) throws NavigatingException
This method is for use by the NavigationManager only.
processNavigatingEvent
in interface Control
event
- The navigating event.
NavigatingException
- Indicates navigation rejected.ControlSupport.processNavigatedEvent(oracle.dacf.control.NavigatedEvent)
public final void dataItemValueChanged(javax.infobus.DataItemValueChangedEvent event)
A reference to the data item that changed can be obtained from the event.
dataItemValueChanged
in interface javax.infobus.DataItemChangeListener
event
- Contains change information.DataItemChangeListener.dataItemValueChanged(javax.infobus.DataItemValueChangedEvent)
public final void dataItemAdded(javax.infobus.DataItemAddedEvent event)
A reference to the data item that was added, and a reference to the one that gained it, can be obtained from the event.
dataItemAdded
in interface javax.infobus.DataItemChangeListener
event
- Contains details of the addition.DataItemChangeListener.dataItemAdded(javax.infobus.DataItemAddedEvent)
public final void dataItemDeleted(javax.infobus.DataItemDeletedEvent event)
A reference to the data item that was deleted, and a reference to the one that lost it, can be obtained from the event.
dataItemDeleted
in interface javax.infobus.DataItemChangeListener
event
- Contains details of the deletion.DataItemChangeListener.dataItemDeleted(javax.infobus.DataItemDeletedEvent)
public final void dataItemRevoked(javax.infobus.DataItemRevokedEvent event)
A reference to the data item that was revoked can be obtained from the event.
dataItemRevoked
in interface javax.infobus.DataItemChangeListener
event
- Contains details of the revoked data.DataItemChangeListener.dataItemRevoked(javax.infobus.DataItemRevokedEvent)
public final void rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent event)
A reference to the rowset data item can be obtained from the event.
rowsetCursorMoved
in interface javax.infobus.DataItemChangeListener
event
- Contains details of the cursor move.DataItemChangeListener.rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent)
public java.lang.String toString()
protected javax.swing.ListSelectionModel createSelectionModel()
public java.lang.String getMode()
public java.lang.String getName(java.lang.Object newDataItem)
newDataItem
- data itempublic void setDataItemNameForUpdate(java.lang.String valueDataItemName)
setDataItemNameForUpdate
in interface DualBindingControl
valueDataItemName
- Fully qaulified name of the
name of the dataitempublic java.lang.String getDataItemNameForUpdate()
getDataItemNameForUpdate
in interface DualBindingControl
public void setDataItemUsageMode(int usage)
setDataItemUsageMode
in interface DualBindingControl
public int getDataItemUsageMode()
getDataItemUsageMode
in interface DualBindingControl
public void setOpaque(boolean isOpaque)
public void setToolTipText(java.lang.String text)
public javax.swing.ListCellRenderer getCellRenderer()
public void setCellRenderer(javax.swing.ListCellRenderer cellRenderer)
public final void setFixedCellHeight(int fixedCellHeight)
JList
public final int getFixedCellHeight()
JList
public final void setFixedCellWidth(int fixedCellWidth)
JList
public final int getFixedCellWidth()
JList
public void setModel(javax.swing.ListModel model)
public javax.swing.ListModel getModel()
public void setPrototypeCellValue(java.lang.Object prototypeCellValue)
public java.lang.Object getPrototypeCellValue()
public void setSelectedIndex(int index)
index
- the position where the selection should be
movedpublic int getSelectedIndex()
public void setSelectedIndices(int[] indices)
public int[] getSelectedIndices()
public final void setSelectionBackground(java.awt.Color selectionBackground)
JList
public final java.awt.Color getSelectionBackground()
JList
public final void setSelectionForeground(java.awt.Color selectionForeground)
JList
public final java.awt.Color getSelectionForeground()
JList
public void setSelectionMode(int selectionMode)
public int getSelectionMode()
public void setSelectionModel(javax.swing.ListSelectionModel selectionModel)
public javax.swing.ListSelectionModel getSelectionModel()
public void setValueIsAdjusting(boolean b)
public boolean getValueIsAdjusting()
public void setVisibleRowCount(int rows)
JList
public int getVisibleRowCount()
JList
|
Oracle Data-aware Controls Reference | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2003, Oracle. All rights reserved.