oracle.jbo.uicli.binding
Class JUCtrlRangeBinding

java.lang.Object
  |
  +--oracle.jbo.uicli.binding.JUControlBinding
        |
        +--oracle.jbo.uicli.binding.JUCtrlValueBinding
              |
              +--oracle.jbo.uicli.binding.JUCtrlRangeBinding

All Implemented Interfaces:

AttributeList

Direct Known Subclasses:

GraphDataFromCol, JUCtrlHierBinding, JUCtrlHierNodeBinding, JUGraphBinding, JUTableBinding

public abstract class JUCtrlRangeBinding

extends JUCtrlValueBinding

A JUControlBinding class responsible for binding controls/models that are bound to a range of Row objects in the BC4J layer. This class:

• Is responsible for updating the Control Bindings with attribute values from the BC4J Row objects for all attributes that this Control Binding is bound to by calling setValueAt() method for each attribute value with approprate row, column and value information.
• Declares (abstract) methods that all subclasses need to implement to handle Scroll and Navigation events from the BC4J RowIterator.

Constructor Summary

JUCtrlRangeBinding(java.lang.Object control, JUIteratorBinding iterBinding, java.lang.String[] attrNames)
This constructor passes on the control, iterator, and attribute binding information to its super.

Method Summary

long	getEstimatedRowCount() Returns the number of rows in the collection defined by the associated ViewObject's query (if this control is in data display mode).
abstract java.lang.Object	getValueAt(int rowIndex, int attrIndex) Returns the value as stored in the control at a given row and column index.
void	refreshControl() *** For internal framework use only ***
abstract void	setValueAt(java.lang.Object value, int rowIndex, int attrIndex) Sets the given value from a BC4J row into the control at the given row/column.
void	updateNavigated(NavigationEvent event) Method to handle Navigation event from the BC4J iterator.
void	updateRangeScrolled(ScrollEvent event) Method to handle scroll events from the BC4J iterator.
void	updateValuesFromRow(Row row) This method is called in the framework when values of a single row need to be updated in a control (typically on a navigation event).
void	updateValuesFromRows(Row[] rows, boolean clear) This method is invoked in the framework to update values displayed in the associated control.

Methods inherited from class oracle.jbo.uicli.binding.JUCtrlValueBinding

findAttributeDef, getAttribute, getAttribute, getAttributeCount, getAttributeDef, getAttributeDefs, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeIndexOf, getAttributeNames, getAttributeValues, isArrayIteratorType, isAttributeUpdateable, setArrayIteratorType, setAttribute, setAttribute, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, stopEditing, updateRowDeleted, updateRowInserted

Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding

addControlToPanel, executeQuery, executeQueryIfNeeded, getAllRowsInRange, getApplicationModule, getControl, getCurrentRow, getDef, getFormBinding, getIteratorBinding, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, isControlQueriable, reportException, reportException, setFormBinding, setName

Methods inherited from class java.lang.Object

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

Constructor Detail

JUCtrlRangeBinding

public JUCtrlRangeBinding(java.lang.Object control,
JUIteratorBinding iterBinding,
                          java.lang.String[] attrNames)

This constructor passes on the control, iterator, and attribute binding information to its super.

Method Detail

getValueAt

public abstract java.lang.Object getValueAt(int rowIndex,
                                            int attrIndex)

Returns the value as stored in the control at a given row and column index. This value is used by the binding to update attribute values in BC4J rows.

setValueAt

public abstract void setValueAt(java.lang.Object value,
                                int rowIndex,
                                int attrIndex)

Sets the given value from a BC4J row into the control at the given row/column. This method is used by the framework to pass attribute values from Row objects into a control with which this binding works.

getEstimatedRowCount

public long getEstimatedRowCount()

Returns the number of rows in the collection defined by the associated ViewObject's query (if this control is in data display mode). If this control is in find mode, returns the number of rows in the associated ViewCriteria object.

updateValuesFromRow

public void updateValuesFromRow(Row row)

This method is called in the framework when values of a single row need to be updated in a control (typically on a navigation event).

Overrides:

updateValuesFromRow in class JUCtrlValueBinding

updateValuesFromRows

public void updateValuesFromRows(Row[] rows,
                                 boolean clear)

This method is invoked in the framework to update values displayed in the associated control. This implementation updates all values given in the array of rows irrespective of the clear flag (which indicates whether to clear out the existing displayed values or not).

Specified by:

updateValuesFromRows in class JUCtrlValueBinding

updateRangeScrolled

public void updateRangeScrolled(ScrollEvent event)

Method to handle scroll events from the BC4J iterator. Subclasses need to implement this method to update the currently displayed rowset (if desired).

Specified by:

updateRangeScrolled in class JUCtrlValueBinding

See Also:

ScrollEvent

updateNavigated

public void updateNavigated(NavigationEvent event)

Method to handle Navigation event from the BC4J iterator. Subclasses need to implement this method to update their current row display (if desired).

Specified by:

updateNavigated in class JUCtrlValueBinding

refreshControl

public void refreshControl()

*** For internal framework use only ***

Updates the values in a control that is bound using an Iterator already in use. (a valid row iterator) If you do not call this method, your control won't update unless you refresh the Iterator.

Specified by:

refreshControl in class JUControlBinding