Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 2 (11.1.2.3.0)

E17483-04


oracle.jbo.uicli.binding
Class JUCtrlScrollBinding

java.lang.Object
  extended by java.util.AbstractMap
      extended by oracle.jbo.common.JboAbstractMap
          extended by oracle.adf.model.binding.DCControlBinding
              extended by oracle.jbo.uicli.binding.JUControlBinding
                  extended by oracle.jbo.uicli.binding.JUCtrlScrollBinding

All Implemented Interfaces:
java.util.EventListener, java.util.Map, RowNavigationListener, RowSetListener
Direct Known Subclasses:
JUProgressBarBinding, JUScrollBarBinding, JUSliderBinding

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.


Nested Class Summary

 

Nested classes/interfaces inherited from class java.util.AbstractMap
java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

 

Nested classes/interfaces inherited from interface java.util.Map
java.util.Map.Entry<K,V>

 

Field Summary
protected  int mExt
           
protected  boolean mInited
           
protected  int mMax
           
protected  int mMin
           
protected  boolean mScrollCurrRow
           
protected  boolean mUseEstRC
           
protected  int mVal
           

 

Fields inherited from class oracle.adf.model.binding.DCControlBinding
ATTR_CURRENTROW, ATTR_DEF, ATTR_ERROR, ATTR_ERRORS, ATTR_FULLNAME, ATTR_ITER, ATTR_NAME, DC_BINDING_ERROR, mAttributeListener, mInternalGet_KeyResolved, mPermission, mPermissionInfo, ROW_KEY_STR

 

Fields inherited from class oracle.jbo.common.JboAbstractMap
MAP_NULL_VALUE

 

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
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.
protected  void initResources()
          Invoked when the bindingContainer is being initialized for the first time or after it's locale is changed.
 void navigated(NavigationEvent event)
          Invoked when the current-row designation changes.
protected  boolean needsEstimatedRowCount()
           
 void rangeRefreshed(RangeRefreshEvent event)
          Invoked when the range changes.
 void rangeScrolled(ScrollEvent event)
          Invoked when the range is scrolled.
 void refreshControl()
          *** For internal framework use only ***
 void release(int flags)
           
protected  void resetInputState()
          Empty method to support DCControlBinding contract.
 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, getCurrentRow, getFormBinding, getIteratorBinding, reportException, setFormBinding

 

Methods inherited from class oracle.adf.model.binding.DCControlBinding
addToDCExceptions, clearAttrDefs, evaluateBooleanExpression, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getAttributeListener, getBindingContainer, getControl, getControlModel, getDCIteratorBinding, getDef, getDefFullName, getDefName, getError, getErrors, getFullName, getLayoutObject, getName, getPermission, getPermissionInfo, getPermissionTargetName, getRowAtRangeIndex, getRowIterator, getState, getTransaction, getViewableExpr, getViewObject, hasAttributeListener, hashCode, internalGet, internalHasPermission, internalHasPermission, internalSetName, isControlQueriable, isControlViewable, isReleased, processInputException, release, removeFromDCExceptions, reportException, resetAttributeExceptionInRow, restoreFromState, setBindingContainer, setControl, setDataControlPinned, setDef, setIteratorBinding, setListener, setListener, setName, setViewableExpr, toString

 

Methods inherited from class oracle.jbo.common.JboAbstractMap
entrySet, equals, internalPut, put, setThrowIfPropertyNotFoundOnGet

 

Methods inherited from class java.util.AbstractMap
clear, clone, containsKey, containsValue, isEmpty, keySet, putAll, remove, size, values

 

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, 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

mInited

protected boolean mInited

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

initResources

protected void initResources()
Description copied from class: DCControlBinding
Invoked when the bindingContainer is being initialized for the first time or after it's locale is changed. This gives subclasses a chance to drop their initialized locale based resources.
Specified by:
initResources in class DCControlBinding

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
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
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
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
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
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 RowNavigationListener
Specified by:
navigated in interface 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.

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 DCControlBinding

release

public void release(int flags)
Overrides:
release in class DCControlBinding

resetInputState

protected void resetInputState()
Empty method to support DCControlBinding contract.
Specified by:
resetInputState in class DCControlBinding

needsEstimatedRowCount

protected boolean needsEstimatedRowCount()
Overrides:
needsEstimatedRowCount in class DCControlBinding

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 2 (11.1.2.3.0)

E17483-04


Copyright © 1997, 2012, Oracle. All rights reserved.