|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01 | ||||||||||
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[] |
mLovAttrs
Attribute names that are being displayed by this LOV. |
protected JULovPanelInterface |
mLovPanel
Panel 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)
JUCtrlListBinding
If 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 JUCtrlListBinding
public java.lang.Object getValueAt(int attrIndex)
JUCtrlAttrsBinding
getValueAt
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)
JUCtrlAttrsBinding
setValueAt
in class JUCtrlListBinding
public 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 JUCtrlListBinding
public void actionPerformed(java.awt.event.ActionEvent evt)
actionPerformed
in interface java.awt.event.ActionListener
public void performLOVAction()
public boolean isArmed()
isArmed
in interface javax.swing.ButtonModel
public boolean isSelected()
isSelected
in interface javax.swing.ButtonModel
public boolean isEnabled()
isEnabled
in interface javax.swing.ButtonModel
public boolean isPressed()
isPressed
in interface javax.swing.ButtonModel
public boolean isRollover()
isRollover
in interface javax.swing.ButtonModel
public void setArmed(boolean b)
setArmed
in interface javax.swing.ButtonModel
public void setSelected(boolean b)
setSelected
in interface javax.swing.ButtonModel
public void setEnabled(boolean b)
setEnabled
in interface javax.swing.ButtonModel
public void setPressed(boolean b)
setPressed
in interface javax.swing.ButtonModel
public void setRollover(boolean b)
setRollover
in interface javax.swing.ButtonModel
public void setMnemonic(int key)
setMnemonic
in interface javax.swing.ButtonModel
public int getMnemonic()
getMnemonic
in interface javax.swing.ButtonModel
public void setActionCommand(java.lang.String s)
setActionCommand
in interface javax.swing.ButtonModel
public java.lang.String getActionCommand()
getActionCommand
in interface javax.swing.ButtonModel
public void setGroup(javax.swing.ButtonGroup group)
setGroup
in interface javax.swing.ButtonModel
public void addActionListener(java.awt.event.ActionListener l)
addActionListener
in interface javax.swing.ButtonModel
public void removeActionListener(java.awt.event.ActionListener l)
removeActionListener
in interface javax.swing.ButtonModel
public void addItemListener(java.awt.event.ItemListener l)
addItemListener
in interface javax.swing.ButtonModel
public void removeItemListener(java.awt.event.ItemListener l)
removeItemListener
in interface javax.swing.ButtonModel
public void addChangeListener(javax.swing.event.ChangeListener l)
addChangeListener
in interface javax.swing.ButtonModel
public void removeChangeListener(javax.swing.event.ChangeListener l)
removeChangeListener
in interface javax.swing.ButtonModel
public java.lang.Object[] getSelectedObjects()
getSelectedObjects
in interface java.awt.ItemSelectable
public RowSetIterator getLOVRowSetIterator()
public java.lang.Object findMatchingListValue(java.lang.Object val)
findMatchingListValue
in class JUCtrlListBinding
public int findListIndex(java.lang.Object val)
findListIndex
in class JUCtrlListBinding
public java.lang.Object getValueFromList(int listIndex)
getValueFromList
in class JUCtrlListBinding
public java.lang.Object[] getValueList()
Method not implemented
getValueList
in class JUCtrlListBinding
public java.util.ArrayList getDisplayList()
Method not implemented
public void updateValuesFromRow(Row row)
JUCtrlAttrsBinding
This 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-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2004, Oracle. All rights reserved.