|
Business Components | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.jbo.uicli.binding.JUControlBinding | +--oracle.jbo.uicli.binding.JUCtrlValueBinding | +--oracle.jbo.uicli.binding.JUCtrlAttrsBinding | +--oracle.jbo.uicli.binding.JUCtrlListBinding | +--oracle.jbo.uicli.jui.JUListSingleSelBinding
Implements binding a swing JList (in single selection mode) to a BC4J Attribute or ViewObject or as LOV.
A list can be bound in the following ways:
This class also implements ListSelectionListener interface and listens to ListSelectionEvent from the bound list. On selection event, it either performs an update of the target ViewObject attributes, or iterates a target ViewObject as per the list operation mode set in the constructor.
Fields inherited from class oracle.jbo.uicli.binding.JUCtrlListBinding |
LIST_OPER_NAVIGATE, LIST_OPER_SET_ATTRIBUTE, mListAttrNames,
mListDisplayAttrNames, mListIterBinding, mStaticList,
mValueList |
Constructor Summary |
JUListSingleSelBinding(javax.swing.JList list,
JUIteratorBinding iterBinding,
java.lang.String[] attrNames,
int listOperMode,
boolean shouldScroll)
Binds a ListBox to a RowSet associated with the given iterator binding and based on listOperMode setting, either iterates the currency on the target iterator or updates the attribute value for the given attribute (in attrNames) in the current row in the target RowSet. |
JUListSingleSelBinding(javax.swing.JList list,
JUIteratorBinding iterBinding,
java.lang.String[] attrNames,
JUIteratorBinding listRSI,
java.lang.String[] listAttrNames,
java.lang.String[] listDisplayedAttrNames,
boolean shouldScroll)
Binds separate ViewObject/RowSets for display and update to the same listbox. |
JUListSingleSelBinding(javax.swing.JList list,
JUIteratorBinding iterBinding,
java.lang.String[] attrNames,
java.lang.Object[] valueList,
boolean shouldScroll)
Binds a JList to an attribute in the associated RowSet. |
Method Summary |
Type | Method |
---|---|
void |
addControlToPanel(java.lang.Object panel,
java.lang.Object layoutObject,
java.lang.Object layoutCons)
*** For internal framework use only *** |
void |
addListDataListener(javax.swing.event.ListDataListener l)
|
static javax.swing.ListModel |
createEnumerationBinding(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String attrName,
java.lang.Object[] values)
Use this method to bind a list control to a ViewObject/RowSet identified by voInstanceName when a static list of values are displayed in the listbox, and the listbox is used to display update the same attribute in the same viewobject. |
static javax.swing.ListModel |
createLovBinding(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] attrNames,
java.lang.String listVOInstanceName)
|
static javax.swing.ListModel |
createLovBinding(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] voAttrNames,
java.lang.String lovVOInstanceName,
java.lang.String[] lovVOAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
javax.swing.ListCellRenderer cellRenderer)
Use this binding when two ViewObjects are to be used in this list control, one for displaying the list of values and the other ViewObject, rows of which are updated. |
static javax.swing.ListModel |
createNavigationBinding(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] voAttrNames,
javax.swing.ListCellRenderer cellRenderer)
Use this binding when the given list control is used as a navigation control to iterate through a range or rows in a RowSet. |
java.lang.Object |
getElementAt(int index)
|
static javax.swing.ListModel |
getInstance(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] attrNames,
java.lang.String listVOInstanceName)
Deprecated. since 9.0.2 use createEnumerationBinding, createNavigationBinding or createLovBinding instead |
static javax.swing.ListModel |
getInstance(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] voAttrNames,
java.lang.String lovVOInstanceName,
java.lang.String[] lovVOAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
javax.swing.ListCellRenderer cellRenderer)
Deprecated. since 9.0.2 use createEnumerationBinding, createNavigationBinding or createLovBinding instead |
static javax.swing.ListModel |
getInstance(JUFormBinding formBinding,
javax.swing.JList control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String attrName,
java.lang.Object[] values)
Deprecated. since 9.0.2 use createEnumerationBinding, createNavigationBinding or createLovBinding instead |
java.lang.Object |
getLayoutObject()
*** For internal framework use only *** |
protected javax.swing.ListModel |
getModelImpl(javax.swing.JList control)
Sets the model reference in this binding class by using the current model in the listbox. |
int |
getSize()
|
void |
removeListDataListener(javax.swing.event.ListDataListener l)
|
void |
setDataValueAt(java.lang.Object value,
int attrIndex)
This method is overridden to be a noop. |
void |
setLayoutObject(javax.swing.JScrollPane scrollPane)
*** For internal framework use only *** |
void |
setSelectedIndex(int listIndex)
Sets the item at the given index as current selection in the listbox. |
protected void |
setupListItems(boolean clean,
boolean keepSelectedIndex)
This method is used by the framwork to setup the list of values that will be displayed in this listbox. |
void |
setValueAt(java.lang.Object value,
int attrIndex)
Finds the item in the list that matches the given value and sets it as the current item |
void |
valueChanged(javax.swing.event.ListSelectionEvent e)
Based on listOperMode, this binding either navigates the target rowset to the selected row or sets the attribute/attributes as per the settings in the constructor. |
Methods inherited from class oracle.jbo.uicli.binding.JUCtrlListBinding |
convertValueList, findListIndex, findMatchingListValue,
findValue, getAttrValuesFromRSI, getListOperMode, getSelectedIndex, getSelectedValue,
getValueAt, getValueFromList, getValueList,
isSingleAttrList, matchTargetWithLov, navigated, rangeRefreshed, rangeScrolled, rowDeleted, rowInserted,
rowUpdated, setAttributeFromValueList, setListOperMode,
setSingleAttrList, setTargetAttrsFromLovRow,
setValueList, updateValuesFromRow |
Methods inherited from class oracle.jbo.uicli.binding.JUCtrlAttrsBinding |
updateNavigated, updateRangeScrolled,
updateValuesFromRows |
Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding |
executeQuery, executeQueryIfNeeded, getAllRowsInRange,
getApplicationModule, getControl, getCurrentRow,
getDef, getFormBinding, getIteratorBinding,
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 |
public JUListSingleSelBinding(javax.swing.JList list, JUIteratorBinding iterBinding, java.lang.String[] attrNames, int listOperMode, boolean shouldScroll)
list
- JList control instance to associate this binding with.iterBinding
- provides the RowSet from which this binding accesses data
to display in the list and optionally the current row in which attribute(s)
is to be updated.attrNames
- an ordered array of attribute names to display and optionally update
in a ViewObject.listOperMode
- Can be one of two values:
shouldScroll
- when true indicates scroll the selected item into view
if it's not being displayed in the current viewport..public JUListSingleSelBinding(javax.swing.JList list, JUIteratorBinding iterBinding, java.lang.String[] attrNames, java.lang.Object[] valueList, boolean shouldScroll)
list
- JList control instance to associate this binding with.iterBinding
- provides the RowSet that is used to update current selection
from the listbox into the current row in the rowset.attrNames
- provides the name of an attribute (only one attribute is updateable in
this mode).valueList
- a static list of values that are displayed as options in the listbox
to select from.shouldScroll
- when true indicates scroll the selected item into view
if it's not being displayed in the current viewport..public JUListSingleSelBinding(javax.swing.JList list, JUIteratorBinding iterBinding, java.lang.String[] attrNames, JUIteratorBinding listRSI, java.lang.String[] listAttrNames, java.lang.String[] listDisplayedAttrNames, boolean shouldScroll)
list
- JList control instance to associate this binding with.iterBinding
- provides the RowSet in which the current row is updated
based on selection in the listbox.attrNames
- an ordered array of attribute names to update
in a ViewObject. This list should have the same number of attributes as
in listAttrNames which provides the corresponding attribute names from the
display ViewObject/RowSet.listIterBinding
- provides the RowSet which is used to display data in the
listbox.listAttrNames
- An ordered list of attribute names which are used to
get the values to update into the attributes from the attrNames list in the
target ViewObject. If this list is null, the attribute names for display
are set the same as attrNameslistDisplayAttrNames
- An ordered list of attribute names that specify
the attributes to display from rows in the display ViewObject/RowSet.
If this list is null, attribute names are assumed to be same as in attrNamesshouldScroll
- when true indicates scroll the selected item into view
if it's not being displayed in the current viewport..Method Detail |
protected void setupListItems(boolean clean, boolean keepSelectedIndex)
setupListItems
in class JUCtrlListBinding
clean
- means whether to clean the existing entries in the listbox.keepSelectedIndex
- indicates whether to maintain current index as the selected index
after the display data is updated. If this value is true, the current index is maintained.
However if the current index is more than the number of items in the listbox, the selection
is reset to the first item.protected javax.swing.ListModel getModelImpl(javax.swing.JList control)
public void addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons)
addControlToPanel
in class JUControlBinding
public java.lang.Object getLayoutObject()
getLayoutObject
in class JUControlBinding
public void setLayoutObject(javax.swing.JScrollPane scrollPane)
public void setValueAt(java.lang.Object value, int attrIndex)
setValueAt
in class JUCtrlAttrsBinding
value
- This value is used in findMatchingListValue method to find out the item in
the list that represents the given value. If the value is not found, no item is selected
in the list.attrIndex
- This argument is ignored by this methodpublic void setDataValueAt(java.lang.Object value, int attrIndex)
setDataValueAt
in class JUCtrlAttrsBinding
public void setSelectedIndex(int listIndex)
setSelectedIndex
in class JUCtrlListBinding
public void valueChanged(javax.swing.event.ListSelectionEvent e)
valueChanged
in interface javax.swing.event.ListSelectionListener
public int getSize()
getSize
in interface javax.swing.ListModel
public java.lang.Object getElementAt(int index)
getElementAt
in interface javax.swing.ListModel
public void addListDataListener(javax.swing.event.ListDataListener l)
addListDataListener
in interface javax.swing.ListModel
public void removeListDataListener(javax.swing.event.ListDataListener l)
removeListDataListener
in interface javax.swing.ListModel
public static javax.swing.ListModel createLovBinding(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] attrNames, java.lang.String listVOInstanceName)
public static javax.swing.ListModel getInstance(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] attrNames, java.lang.String listVOInstanceName)
public static javax.swing.ListModel createEnumerationBinding(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String attrName, java.lang.Object[] values)
public static javax.swing.ListModel getInstance(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String attrName, java.lang.Object[] values)
public static javax.swing.ListModel createLovBinding(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] voAttrNames, java.lang.String lovVOInstanceName, java.lang.String[] lovVOAttrNames, java.lang.String[] lovVODisplayedAttrNames, javax.swing.ListCellRenderer cellRenderer)
public static javax.swing.ListModel getInstance(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] voAttrNames, java.lang.String lovVOInstanceName, java.lang.String[] lovVOAttrNames, java.lang.String[] lovVODisplayedAttrNames, javax.swing.ListCellRenderer cellRenderer)
public static javax.swing.ListModel createNavigationBinding(JUFormBinding formBinding, javax.swing.JList control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] voAttrNames, javax.swing.ListCellRenderer cellRenderer)
|
Business Components | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |