|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-02 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Object
java.util.AbstractMap
oracle.jbo.common.JboAbstractMap
oracle.adf.model.binding.DCControlBinding
oracle.jbo.uicli.binding.JUControlBinding
oracle.jbo.uicli.binding.JUCtrlValueBinding
oracle.jbo.uicli.binding.JUCtrlAttrsBinding
oracle.jbo.uicli.binding.JUCtrlListBinding
oracle.jbo.uicli.jui.JULovButtonBinding
Binds a JButton with an iterator such that on button action, an LOV dialog (either a framework default dialog or an application-specific one) is displayed; upon the dialog close, the current row from the associated iterator is used to update values of bound attributes in a target row of a target RowIterator. This behavior is similar to JUComboBoxBinding or JUListSingleSelBinding in their LOV Mode. This kind of control/binding is used when the LOV row count is large enough to make navigation in a ListBox or ComboBox difficult. Also this binding allows easier application customization as the display of LOV data is completely delegated to the LOV dialog/LOV panel.
JUComboBoxBinding, JUListSingleSelBinding| Nested Class Summary |
| Nested classes inherited from class java.util.Map |
java.util.Map.Entry |
| Field Summary | |
protected java.lang.String[] |
mLovAttrsAttribute names that are being displayed by this LOV. |
protected JULovPanelInterface |
mLovPanelPanel that displays LOV data. |
| Fields inherited from class oracle.jbo.uicli.binding.JUCtrlListBinding |
DH_CONTROL_TYPE, DH_DISPLAY_HEIGHT, DH_DISPLAY_HINT, DH_DISPLAY_WIDTH, DH_FORMAT, DH_LABEL, DH_TOOLTIP, LIST_OPER_NAVIGATE, LIST_OPER_SET_ATTRIBUTE, LISTITEM_DisplayValues, LISTITEM_Index, LISTITEM_Prompt, LISTITEM_Selected, LISTITEM_SelectedIndex, mFirstDisplayAttr, mListAttrNames, mListDisplayAttrNames, mListIterBinding, mSingleAttrList, mStaticList, mValueList |
| Fields inherited from class oracle.jbo.uicli.binding.JUCtrlValueBinding |
ATTR_ATTRIBUTE, ATTR_ATTRIBUTE_DEF, ATTR_ATTRIBUTE_DEFS, ATTR_ATTRIBUTE_VALUE, ATTR_ATTRIBUTE_VALUES, ATTR_ATTRIBUTES, ATTR_DISPLAY_HINT, ATTR_INPUT_VALUE, ATTR_LABEL, ATTR_LABELS, ATTR_LABELSET, ATTR_MANDATORY, ATTR_TOOLTIP, ATTR_UPDATEABLE, mHasInputVal, mInputVal, SEP_LIST_DISPLAY |
| Fields inherited from class oracle.adf.model.binding.DCControlBinding |
ATTR_CURRENTROW, ATTR_DEF, ATTR_ERROR, ATTR_ERRORS, ATTR_FULLNAME, ATTR_ITER, ATTR_NAME, mInternalGet_KeyResolved, ROW_KEY_STR |
| Constructor Summary | |
JULovButtonBinding(java.lang.Object control, JUIteratorBinding iterBinding, java.lang.String[] targetAttrs, JUIteratorBinding lovIter, java.lang.String[] listAttrNames, java.lang.String[] lovVODisplayedAttrNames, boolean searchability, java.lang.String title, java.awt.Point location) |
|
JULovButtonBinding(java.lang.Object control, JUIteratorBinding iterBinding, java.lang.String[] targetAttrs, RowSetIterator lovRsi, java.lang.String[] lovVOAttrNames, java.lang.String[] lovVODisplayedAttrNames)Deprecated. since 10g, use the constructor with IteratorBinding instead of RowSetIterator |
|
JULovButtonBinding(java.lang.Object control, JUIteratorBinding iterBinding, java.lang.String[] targetAttrs, RowSetIterator lovRsi, java.lang.String[] listAttrNames, java.lang.String[] lovVODisplayedAttrNames, boolean searchability, java.lang.String title, java.awt.Point location)Deprecated. since 10g, use the constructor with IteratorBinding instead of RowSetIterator |
|
JULovButtonBinding(java.lang.Object control, JUIteratorBinding iterBinding, java.lang.String[] targetAttrs, RowSetIterator lovRsi, java.lang.String[] listAttrNames, java.lang.String[] lovVODisplayedAttrNames, JULovPanelInterface lovPanel) |
|
| Method Summary | |
void |
actionPerformed(java.awt.event.ActionEvent evt) |
void |
addActionListener(java.awt.event.ActionListener l) |
void |
addChangeListener(javax.swing.event.ChangeListener l) |
void |
addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons)*** For internal framework use only *** |
void |
addItemListener(java.awt.event.ItemListener l) |
static javax.swing.ButtonModel |
createLovBinding(JUFormBinding formBinding, javax.swing.AbstractButton 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)This method should be used to create a JULovButtonBinding and bind it to a JButton control. |
static javax.swing.ButtonModel |
createLovBinding(JUFormBinding formBinding, javax.swing.AbstractButton control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] voAttrNames, java.lang.String lovVOInstanceName, java.lang.String lovVOIterName, java.lang.String lovVOIterBindingName, java.lang.String[] lovVOAttrNames, java.lang.String[] lovVODisplayedAttrNames, boolean searchability, java.lang.String title, java.awt.Point location)This method should be used to create a JULovButtonBinding and bind it to a JButton control. |
static javax.swing.ButtonModel |
createLovBinding(JUFormBinding formBinding, javax.swing.AbstractButton control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String[] voAttrNames, java.lang.String lovVOInstanceName, java.lang.String lovVOIterName, java.lang.String lovVOIterBindingName, java.lang.String[] lovVOAttrNames, java.lang.String[] lovVODisplayedAttrNames, JULovPanelInterface lovPanel)This method should be used to create a JULovButtonBinding and bind it to a JButton control. |
int |
findListIndex(java.lang.Object val) |
java.lang.Object |
findMatchingListValue(java.lang.Object val) |
java.lang.String |
getActionCommand() |
java.lang.Object |
getControlModel(java.lang.Object control)Gets the associated View's model object. |
java.util.ArrayList |
getDisplayList()*** For internal framework use only *** |
static javax.swing.ButtonModel |
getInstance(JUFormBinding formBinding, javax.swing.AbstractButton 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)Deprecated. since 9.0.2 use createLovBinding() |
JULovPanelInterface |
getLovPanelInterface() |
RowSetIterator |
getLOVRowSetIterator()Returns the RowSet Iterator used to display LOV data. |
int |
getMnemonic() |
protected javax.swing.ButtonModel |
getModelImpl(java.lang.Object control)*** For internal framework use only *** |
java.lang.Object[] |
getSelectedObjects() |
java.lang.Object |
getValueAt(int attrIndex)Gets the value from the control for the attribute at the given index. |
java.lang.Object |
getValueFromList(int listIndex) |
java.lang.Object[] |
getValueList()*** For internal framework use only *** |
boolean |
isArmed() |
boolean |
isEnabled() |
boolean |
isNavigationMode() |
boolean |
isPressed() |
boolean |
isRollover() |
boolean |
isSelected() |
void |
performLOVAction()This method is invoked when action is to be performed on the associated button. |
void |
removeActionListener(java.awt.event.ActionListener l) |
void |
removeChangeListener(javax.swing.event.ChangeListener l) |
void |
removeItemListener(java.awt.event.ItemListener l) |
void |
setActionCommand(java.lang.String s) |
void |
setArmed(boolean b) |
void |
setDataValueAt(java.lang.Object value, int attrIndex) |
void |
setEnabled(boolean b) |
void |
setGroup(javax.swing.ButtonGroup group) |
void |
setHelpAction(java.awt.event.ActionListener al)If the default LOV dialog is being used to display LOV Data, this method should be used by applications to set the ActionListener that is triggered on activating the help button in the LOV Dialog. |
void |
setMnemonic(int key) |
void |
setNavigationMode(boolean flag) |
void |
setPressed(boolean b) |
void |
setRollover(boolean b) |
void |
setSelected(boolean b) |
protected void |
setupListItems(boolean clean, boolean keepSelectedIndex)If this list is displaying a single attribute and updates a single attribute, then this method fetches the attribute value from all the rows in the given LOV list iterator and sets that as the list of values to display in the bound control. |
void |
setValueAt(java.lang.Object value, int attrIndex)Updates the control/control-binding with the latest value of the attribute at the given index with the given value. |
void |
updateValuesFromRow(Row row)Updates the control-binding and hence the control with attribute values from the attributes of this Row. |
| Methods inherited from class oracle.jbo.uicli.binding.JUCtrlAttrsBinding |
createAttributeBinding, refreshControl, setControlEnabled, updateNavigated, updateRangeScrolled, updateValuesFromRows |
| Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding |
getFormBinding, getIteratorBinding, reportException, setFormBinding |
| Methods inherited from class oracle.adf.model.binding.DCControlBinding |
addToDCExceptions, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getBindingContainer, getControl, getCurrentRow, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, hashCode, internalSetName, needsEstimatedRowCount, removeFromDCExceptions, reportException, resetAttributeExceptionInRow, setBindingContainer, setControl, setName |
| Methods inherited from class oracle.jbo.common.JboAbstractMap |
entrySet, equals |
| 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 |
| Methods inherited from interface oracle.jbo.StructureDef |
getDefFullName, getDefName, getFullName, getName |
| Field Detail |
protected java.lang.String[] mLovAttrs
protected JULovPanelInterface mLovPanel
| Constructor Detail |
public JULovButtonBinding(java.lang.Object control,
JUIteratorBinding iterBinding,
java.lang.String[] targetAttrs,
RowSetIterator lovRsi,
java.lang.String[] lovVOAttrNames,
java.lang.String[] lovVODisplayedAttrNames)
public JULovButtonBinding(java.lang.Object control,
JUIteratorBinding iterBinding,
java.lang.String[] targetAttrs,
RowSetIterator lovRsi,
java.lang.String[] listAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
JULovPanelInterface lovPanel)
public JULovButtonBinding(java.lang.Object control,
JUIteratorBinding iterBinding,
java.lang.String[] targetAttrs,
RowSetIterator lovRsi,
java.lang.String[] listAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
boolean searchability,
java.lang.String title,
java.awt.Point location)
public JULovButtonBinding(java.lang.Object control,
JUIteratorBinding iterBinding,
java.lang.String[] targetAttrs,
JUIteratorBinding lovIter,
java.lang.String[] listAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
boolean searchability,
java.lang.String title,
java.awt.Point location)
| Method Detail |
public java.lang.Object getControlModel(java.lang.Object control)
getControlModel in class DCControlBinding
public static javax.swing.ButtonModel createLovBinding(JUFormBinding formBinding,
javax.swing.AbstractButton 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)
formBinding - The containing JUPanelBinding in which the given iterator binding would be found/created.control - The control instance to bind to a ViewObject's attribute.voInstanceName - Name of the instance of the ViewObject in a BC4J ApplicationModule.voIterName - Runtime instance name of the iterator in the ViewObject (optional).voIterBindingName - Instance name of the iterator binding that uniquely identifies an iterator binding object used to read/write data in this given JUPanelBinding instance.voAttrNames - The names of the attributes of the target ViewObject rows that are updated when a LOV row is selected.lovVOInstanceName - Name of the instance of the ViewObject in BC4J application module to use for LOV display and selection.lovVOAttrNames - Names of the attributes that are used to update the target ViewObject attributes.
public static javax.swing.ButtonModel createLovBinding(JUFormBinding formBinding,
javax.swing.AbstractButton control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] voAttrNames,
java.lang.String lovVOInstanceName,
java.lang.String lovVOIterName,
java.lang.String lovVOIterBindingName,
java.lang.String[] lovVOAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
boolean searchability,
java.lang.String title,
java.awt.Point location)
formBinding - The containing JUPanelBinding in which the given iterator binding would be found/created.control - The control instance to bind to a ViewObject's attribute.voInstanceName - Name of the instance of the ViewObject in a BC4J ApplicationModule.voIterName - Runtime instance name of the iterator in the ViewObject (optional).voIterBindingName - Instance name of the iterator binding that uniquely identifies an iterator binding object used to read/write data in this given JUPanelBinding instance.voAttrNames - The names of the attributes of the target ViewObject rows that are updated when a LOV row is selected.lovVOInstanceName - Name of the instance of the ViewObject in BC4J application module to use for LOV display and selection.lovVOIterName - Runtime instance name of the iterator in the LOV ViewObjectlovVOIterBindingName - Instance name of the iterator binding that uniquely identifies an iterator binding object used to get Lov rows.lovVOAttrNames - Names of the attributes that are used to update the target ViewObject attributes.searchability - true if this binding is to allow search mode in the Lov Dialog.title - String that should be displayed as the title of the Lov Dialog.location - Where the Lov dialog should be anchored.
public static javax.swing.ButtonModel createLovBinding(JUFormBinding formBinding,
javax.swing.AbstractButton control,
java.lang.String voInstanceName,
java.lang.String voIterName,
java.lang.String voIterBindingName,
java.lang.String[] voAttrNames,
java.lang.String lovVOInstanceName,
java.lang.String lovVOIterName,
java.lang.String lovVOIterBindingName,
java.lang.String[] lovVOAttrNames,
java.lang.String[] lovVODisplayedAttrNames,
JULovPanelInterface lovPanel)
formBinding - The containing JUPanelBinding in which the given iterator binding would be found/created.control - The control instance to bind to a ViewObject's attribute.voInstanceName - Name of the instance of the ViewObject in a BC4J ApplicationModule.voIterName - Runtime instance name of the iterator in the ViewObject (optional).voIterBindingName - Instance name of the iterator binding that uniquely identifies an iterator binding object used to read/write data in this given JUPanelBinding instance.voAttrNames - The names of the attributes of the target ViewObject rows that are updated when a LOV row is selected.lovVOInstanceName - Name of the instance of the ViewObject in BC4J application module to use for LOV display and selection.lovVOAttrNames - Names of the attributes that are used to update the target ViewObject attributes.lovPanel - the JULovPanelInterface interface default constructor so that it can be instantiated by this binding method.
public static javax.swing.ButtonModel getInstance(JUFormBinding formBinding,
javax.swing.AbstractButton 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)
protected void setupListItems(boolean clean,
boolean keepSelectedIndex)
JUCtrlListBindingIf this list is displaying multiple attributes and/or is used in navigation mode, then the valueList is set with the list of all rows from the LOV Iterator binding. In this case, this binding also listens to events from the RowSetIterator for row currency changes, new rows, etc.
setupListItems in class JUCtrlListBindingpublic java.lang.Object getValueAt(int attrIndex)
JUCtrlAttrsBindinggetValueAt in class JUCtrlListBinding
public void setDataValueAt(java.lang.Object value,
int attrIndex)
setDataValueAt in class JUCtrlListBinding
public void setValueAt(java.lang.Object value,
int attrIndex)
JUCtrlAttrsBindingsetValueAt in class JUCtrlListBindingpublic boolean isNavigationMode()
public void setNavigationMode(boolean flag)
public JULovPanelInterface getLovPanelInterface()
public void setHelpAction(java.awt.event.ActionListener al)
protected javax.swing.ButtonModel getModelImpl(java.lang.Object control)
public void addControlToPanel(java.lang.Object panel,
java.lang.Object layoutObject,
java.lang.Object layoutCons)
addControlToPanel in class JUCtrlListBindingpublic void actionPerformed(java.awt.event.ActionEvent evt)
actionPerformed in interface java.awt.event.ActionListenerpublic void performLOVAction()
public boolean isArmed()
isArmed in interface javax.swing.ButtonModelpublic boolean isSelected()
isSelected in interface javax.swing.ButtonModelpublic boolean isEnabled()
isEnabled in interface javax.swing.ButtonModelpublic boolean isPressed()
isPressed in interface javax.swing.ButtonModelpublic boolean isRollover()
isRollover in interface javax.swing.ButtonModelpublic void setArmed(boolean b)
setArmed in interface javax.swing.ButtonModelpublic void setSelected(boolean b)
setSelected in interface javax.swing.ButtonModelpublic void setEnabled(boolean b)
setEnabled in interface javax.swing.ButtonModelpublic void setPressed(boolean b)
setPressed in interface javax.swing.ButtonModelpublic void setRollover(boolean b)
setRollover in interface javax.swing.ButtonModelpublic void setMnemonic(int key)
setMnemonic in interface javax.swing.ButtonModelpublic int getMnemonic()
getMnemonic in interface javax.swing.ButtonModelpublic void setActionCommand(java.lang.String s)
setActionCommand in interface javax.swing.ButtonModelpublic java.lang.String getActionCommand()
getActionCommand in interface javax.swing.ButtonModelpublic void setGroup(javax.swing.ButtonGroup group)
setGroup in interface javax.swing.ButtonModelpublic void addActionListener(java.awt.event.ActionListener l)
addActionListener in interface javax.swing.ButtonModelpublic void removeActionListener(java.awt.event.ActionListener l)
removeActionListener in interface javax.swing.ButtonModelpublic void addItemListener(java.awt.event.ItemListener l)
addItemListener in interface javax.swing.ButtonModelpublic void removeItemListener(java.awt.event.ItemListener l)
removeItemListener in interface javax.swing.ButtonModelpublic void addChangeListener(javax.swing.event.ChangeListener l)
addChangeListener in interface javax.swing.ButtonModelpublic void removeChangeListener(javax.swing.event.ChangeListener l)
removeChangeListener in interface javax.swing.ButtonModelpublic java.lang.Object[] getSelectedObjects()
getSelectedObjects in interface java.awt.ItemSelectablepublic RowSetIterator getLOVRowSetIterator()
public java.lang.Object findMatchingListValue(java.lang.Object val)
findMatchingListValue in class JUCtrlListBindingpublic int findListIndex(java.lang.Object val)
findListIndex in class JUCtrlListBindingpublic java.lang.Object getValueFromList(int listIndex)
getValueFromList in class JUCtrlListBindingpublic java.lang.Object[] getValueList()
Method not implemented
getValueList in class JUCtrlListBindingpublic java.util.ArrayList getDisplayList()
Method not implemented
public void updateValuesFromRow(Row row)
JUCtrlAttrsBindingThis method also enables/disables the Swing control based on the updateability of the first (Default) attribute to which this control is bound.
updateValuesFromRow in class JUCtrlListBinding
|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-02 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright © 1997, 2005, Oracle. All rights reserved.