oracle.jbo.uicli.binding
Class JUCtrlScrollBinding

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

All Implemented Interfaces:

java.util.EventListener, RowNavigationListener, RowSetListener

Direct Known Subclasses:

oracle.jbo.uicli.jui.JUBoundedRangeBinding

public abstract class JUCtrlScrollBinding

extends JUControlBinding

implements RowSetListener

Implements binding of controls like Scrollbar, Slider, etc to a ViewObject. This class listens to the RowSet events from the associated BC4J RowSet and resets/updates the control/model with appropriate currency and range.

Field Summary

Type	Field
protected int	mExt
protected int	mMax
protected int	mMin
protected boolean	mScrollCurrRow
protected boolean	mUseEstRC
protected int	mVal

Constructor Summary

JUCtrlScrollBinding(java.lang.Object control, JUIteratorBinding iterBinding, boolean scrollCurrRow, boolean deferAssignValues, boolean useEstRC)
Creates an instance of this class bound to the given control and iterator Binding object.

Method Summary

Type	Method
protected void	assignValues() Initializes the binding member variables from the current settings in the associated RowSetIterator.
protected void	bindRowSetIterator(RowSetIterator rsi) Associates the given RowSet iterator with this Binding object.
protected void	initFromRSI() Uses the current RowSetIterator to calculate the current values from the associated RowSetIterator.
void	navigated(NavigationEvent event) Invoked when the current-row designation changes.
void	rangeRefreshed(RangeRefreshEvent event) Invoked when the range changes.
void	rangeScrolled(ScrollEvent event) Invoked when the range is scrolled.
void	rowDeleted(DeleteEvent event) Invoked when a row has been deleted.
void	rowInserted(InsertEvent event) Invoked when a row has been inserted.
void	rowUpdated(UpdateEvent event) Invoked when an attribute of the row has been changed.
void	setRangeScrollValue(int newVal) Sets the currency to the given row index in the current range of rows that the associated iterator is working with.
protected abstract void	setRangeScrollValues(int val, int ext, int minVal, int maxVal) Sets the current iterator state by setting the given set of values on the iterator.
protected abstract void	setValues(int val, int ext, int minVal, int maxVal) Reflects the current iterator state by setting the given set of values on the associated control.

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

Field Detail

mMin

protected int mMin

mMax

protected int mMax

mVal

protected int mVal

mExt

protected int mExt

mScrollCurrRow

protected boolean mScrollCurrRow

mUseEstRC

protected boolean mUseEstRC

Constructor Detail

JUCtrlScrollBinding

public JUCtrlScrollBinding(java.lang.Object control,
                           JUIteratorBinding iterBinding,
                           boolean scrollCurrRow,
                           boolean deferAssignValues,
                           boolean useEstRC)

Creates an instance of this class bound to the given control and iterator Binding object.

Parameters:

scrollCurrRow - Not used.

deferAssignValues - If true, indicates that the iterator's current settings should be immediately applied to the bound control.

useEstRC - If true, indicates that the binding should use getEstimatedRowCount() on the associated iterator to figure out the maximum number of rows in the associated iterator. Otherwise, in-memory row count of the iterator is used.

Method Detail

setValues

protected abstract void setValues(int val,
                                  int ext,
                                  int minVal,
                                  int maxVal)

Reflects the current iterator state by setting the given set of values on the associated control.

Parameters:

val - The current value which indicates the row index of the current row in the current range.

ext - The extent value which is used by a control to scroll that many rows up or down.

minVal - The minimum value that this control allows.

maxVal - The maximum value that this control allows.

setRangeScrollValues

protected abstract void setRangeScrollValues(int val,
                                             int ext,
                                             int minVal,
                                             int maxVal)

Sets the current iterator state by setting the given set of values on the iterator.

Parameters:

val - The current value which indicates the row index of the current row in the current range.

ext - The extent value which is used by a control to scroll that many rows up or down.

minVal - The minimum value that this control allows.

maxVal - The maximum value that this control allows.

initFromRSI

protected void initFromRSI()

Uses the current RowSetIterator to calculate the current values from the associated RowSetIterator.

assignValues

protected void assignValues()

Initializes the binding member variables from the current settings in the associated RowSetIterator. Then sets these values into the model/control using setValues() method.

setRangeScrollValue

public void setRangeScrollValue(int newVal)

Sets the currency to the given row index in the current range of rows that the associated iterator is working with. This method scrolls the current row in the current range, if it falls out of the current range.

rangeRefreshed

public void rangeRefreshed(RangeRefreshEvent event)

Description copied from interface: RowSetListener

Invoked when the range changes.

Specified by:

rangeRefreshed in interface RowSetListener

Following copied from interface: oracle.jbo.RowSetListener

Parameters:

event - a description of the new ranges.

rangeScrolled

public void rangeScrolled(ScrollEvent event)

Description copied from interface: RowSetListener

Invoked when the range is scrolled.

Specified by:

rangeScrolled in interface RowSetListener

Following copied from interface: oracle.jbo.RowSetListener

Parameters:

event - a description of the new range.

rowInserted

public void rowInserted(InsertEvent event)

Description copied from interface: RowSetListener

Invoked when a row has been inserted.

Specified by:

rowInserted in interface RowSetListener

Following copied from interface: oracle.jbo.RowSetListener

Parameters:

event - a description of the new Row object.

rowDeleted

public void rowDeleted(DeleteEvent event)

Description copied from interface: RowSetListener

Invoked when a row has been deleted.

Specified by:

rowDeleted in interface RowSetListener

Following copied from interface: oracle.jbo.RowSetListener

Parameters:

event - a description of the deleted Row object.

rowUpdated

public void rowUpdated(UpdateEvent event)

Description copied from interface: RowSetListener

Invoked when an attribute of the row has been changed.

Specified by:

rowUpdated in interface RowSetListener

Following copied from interface: oracle.jbo.RowSetListener

Parameters:

event - a description of the modified Row object.

navigated

public void navigated(NavigationEvent event)

Description copied from interface: RowSetListener

Invoked when the current-row designation changes.

Specified by:

navigated in interface RowSetListener

Following copied from interface: oracle.jbo.RowSetListener

Parameters:

event - a description of the new and previous current rows.

bindRowSetIterator

protected void bindRowSetIterator(RowSetIterator rsi)

Associates the given RowSet iterator with this Binding object. If this object was working with another RowSet, removes it from the RowSetListener's list of the first RowSet. Adds this object as a RowSetListener in the given RowSet, so that this binding can track rowset scroll and navigation events.