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

Type	Method
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.
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, isAttributeUpdateable, 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, 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).

Overrides:

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

Overrides:

updateRangeScrolled in class JUCtrlValueBinding

Following copied from class: oracle.jbo.uicli.binding.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).

Overrides:

updateNavigated in class JUCtrlValueBinding