Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1)

E10653-04

oracle.jbo.uicli.jui
Class JUComboBoxLovEditBinding

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.JUCtrlValueBinding
                      extended by oracle.jbo.uicli.binding.JUCtrlAttrsBinding
                          extended by oracle.jbo.uicli.binding.JUCtrlListBinding
                              extended by oracle.jbo.uicli.jui.JUComboBoxCtrlBinding
                                  extended by oracle.jbo.uicli.jui.JUComboBoxLovEditBinding
All Implemented Interfaces:
java.awt.event.ActionListener, java.util.EventListener, java.util.Map, javax.swing.ComboBoxModel, javax.swing.ListModel, javax.swing.MutableComboBoxModel, AttributeBinding, ControlBinding, RowNavigationListener, RowSetListener, RowSetManagementListener, StructureDef, JUCtrlInputValueHandler, JUCtrlValueHandler

public class JUComboBoxLovEditBinding
extends JUComboBoxCtrlBinding
implements java.awt.event.ActionListener


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  JUComboBoxLovEditButton comboButton
           
protected  JULovPanelInterface mLovPanel
           
static java.lang.String NO_MATCH_VALUE
           
 
Fields inherited from class oracle.jbo.uicli.jui.JUComboBoxCtrlBinding
mCellRenderer, mComboModel, mEditor, mSettingValue
 
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_ADD_NULL_AT_END, LIST_ADD_NULL_AT_START, LIST_ADD_NULL_NOWHERE, LIST_ADD_NULL_UNINIT, LIST_OPER_MULTI_SELECT, LIST_OPER_NAVIGATE, LIST_OPER_SET_ATTRIBUTE, LISTITEM_DisplayValues, LISTITEM_Index, LISTITEM_Prompt, LISTITEM_Selected, LISTITEM_SelectedIndex, LISTITEM_SelectedIndices, LOV_SRC_ATTRNAMES, LOV_SRC_EL_EXPR, LOV_SRC_ROW, LOV_SRC_ROW_DATA, mFirstDisplayAttr, mListAttrNames, mListDisplayAttrNames, mListIterBinding, mNullValueFlag, mSingleAttrList, mStaticList, mValueList, ROW
 
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_AUTOSUBMIT, ATTR_DISPLAY_HEIGHT, ATTR_DISPLAY_HINT, ATTR_DISPLAY_WIDTH, ATTR_FORMAT, ATTR_FORMATS, ATTR_HINTS, ATTR_INPUT_VALUE, ATTR_LABEL, ATTR_LABELS, ATTR_LABELSET, ATTR_MANDATORY, ATTR_PATH, ATTR_TOOLTIP, ATTR_UPDATEABLE, ATTR_VIEWABLE, DATACHANGE_EVENT_POLICY, GET_ALLOWS, mAttrs, 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, DC_BINDING_ERROR, mAttributeListener, mInternalGet_KeyResolved, mPermission, mPermissionInfo, ROW_KEY_STR
 
Fields inherited from class oracle.jbo.common.JboAbstractMap
MAP_NULL_VALUE
 
Constructor Summary
protected JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb, DCIteratorBinding iterBinding, java.lang.String[] attrNames, java.lang.String lbName, boolean testMode, boolean searchFlag)
          *** For internal framework use only ***
  JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb, JUIteratorBinding iterBinding, java.lang.String[] attrNames, int listOperMode, boolean testMode, boolean searchFlag)
           
  JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb, JUIteratorBinding iterBinding, java.lang.String[] attrNames, JUIteratorBinding listIterBinding, java.lang.String[] listAttrNames, java.lang.String[] listDisplayAttrNames, boolean testMode, boolean searchFlag)
           
  JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb, JUIteratorBinding iterBinding, java.lang.String[] attrNames, java.lang.Object[] valueList, boolean testMode, boolean searchFlag)
          Binds a combobox to an attribute in the associated RowSet.
 
Method Summary
 void actionPerformed(java.awt.event.ActionEvent evt)
          Based on listOperMode, this binding either navigates the target rowset to the selected row or sets the attribute/attributes as based on the settings in the constructor.
 java.lang.Object findMatchingListValue(java.lang.Object val)
           
protected  javax.swing.ButtonModel getButtonModelImpl(javax.swing.AbstractButton button)
          *** For internal framework use only ***
protected  AttributeDef[] getComboDisplayAttrs()
           
protected  javax.swing.JComboBox getControlCombo()
           
 java.lang.Object getControlModel(java.lang.Object control)
          Gets the associated View's model object.
protected  java.util.HashMap getIterBindingDefOptions(DCDataControl dc)
           
 JULovPanelInterface getLovPanelInterface()
           
 boolean invokeLOVAction()
           
 void performLOVAction()
          This method is invoked when action is to be performed on the associated button.
 void setDimension(java.awt.Dimension d)
           
protected  void setupListItems(boolean clean, boolean keepSelectedIndex)
          This method is used by the framwork to setup the list of values (LOV) that will be displayed in this LOV dialog.
 void setValueAt(java.lang.Object value, int attrIndex)
          Finds the item in the combobox that matches the given value and sets it as the current item.
 
Methods inherited from class oracle.jbo.uicli.jui.JUComboBoxCtrlBinding
addControlToPanel, addElement, addListDataListener, createEnumerationBinding, createLovBinding, createNavigationBinding, getDisplayData, getElementAt, getInstance, getInstance, getModelImpl, getNullValueString, getSelectedItem, getSize, getValueAt, init, insertElementAt, isControlQueriable, isRefreshingList, isViewInitialized, refreshComboList, refreshControl, refreshListItem, release, removeElement, removeElementAt, removeListDataListener, setDataValueAt, setSelectedIndex, setSelectedItem, updateTargetFromSelectedValue, updateValueToCurrentRow
 
Methods inherited from class oracle.jbo.uicli.binding.JUCtrlListBinding
addBindingChangeListener, addNullAndSetValueList, addRowToMRU, addSelectionToMRU, bindRowSetIterator, clearMRU, clearSelectedIndices, convertValueList, createListIterBinding, createRowSetIterator, filterList, findAndUpdateSelectedIndex, findListIndex, findListIndex, findShuttleAvailableRows, findShuttleSelectedRows, findValue, getAttributeDefs, getComboDisplayAttributeCount, getDisplayAttributeDefs, getDisplayCriteriaName, getDisplayHints, getDisplayListIterator, getDisplayWidth, getFilteredRowSetIterator, getFilteredRowSetIteratorWithCaseCheck, getInputValueInRow, getInputValueOnError, getListBindingName, getListDisplayAttrNames, getListIterBinding, getListOperMode, getListRowSetIterator, getMRUSize, getMRUString, getNullValueFlag, getNullValueIndex, getPreferredListIterBinding, getPreferredListMode, getPreferredListRowSetIterator, getSelectedIndex, getSelectedIndexValue, getSelectedIndices, getSelectedValue, getSelectedValues, getSelectionAttributeName, getServerBindingName, getTargetRowData, getValueFromList, getValueList, handleFilteredList, hasMRU, hasNullValue, initFromServerBinding, initResources, internalGet, isAutoSubmit, isMandatory, isSingleAttrList, isUpdateable, iteratorClosed, iteratorReset, matchTargetWithLov, moveDown, moveToBottom, moveToTop, moveUp, navigated, processNewInputValue, put, rangeRefreshed, rangeScrolled, removeBindingChangeListener, resetAttributeDefs, resetShuttle, rowDeleted, rowInserted, rowUpdated, setAllowBlindMatchInFilter, setAttributeFromValueList, setDef, setFetchDataOnSetup, setInputValueInRow, setListIterBinding, setListOperMode, setListValueAsSelected, setNullValueProperties, setPreferredListMode, setSelectedIndexValue, setSelectedIndices, setServerBindingName, setStaticList, setTargetAttrsFromLovRow, setValueList, shuttle, toString, updateValuesFromRow, usesServerBinding
 
Methods inherited from class oracle.jbo.uicli.binding.JUCtrlAttrsBinding
createAttributeBinding, setControlEnabled, updateValuesFromRows
 
Methods inherited from class oracle.jbo.uicli.binding.JUCtrlValueBinding
addBindingContainerChangeListenerForCtxEvent, addDataChangeListener, clearAttrDefs, clearEventsCache, compareAndSetAttribute, createAndNotifyDCE, createEventProducer, displayInShortForm, ensureVariableManager, fetchAttrDefs, findAttributeDef, generateDCE, getAttribute, getAttribute, getAttribute, getAttributeCount, getAttributeDef, getAttributeDef, getAttributeDefsForRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeIndexOf, getAttributeNames, getAttributes, getAttributes, getAttributeUIHelper, getAttributeValidators, getAttributeValidators, getAttributeValue, getAttributeValue, getAttributeValueFromRow, getAttributeValues, getAttributeValues, getAttrViewExpressions, getBindingHint, getCachedEvents, getChangeEventPolicy, getColumnNameForQuery, getControlType, getDataChangeEventPolicy, getDataChangeListener, getDisplayHeight, getDisplayHint, getError, getErrors, getEventProducer, getFormat, getFormats, getFormattedAttributeValue, getHint, getHint, getHints, getInputErrorsForRowKey, getInputValue, getInputValue, getInputValueHandler, getIteratorBindingForDCE, getIteratorRenderHint, getLabel, getLabel, getLabels, getLabelSet, getLastEventId, getLocaleContext, getMasterKeyPathForDCE, getMergedAttributeValues, getPath, getPermissionDef, getPermissionHolder, getPermissionInfo, getSelectionDef, getState, getTooltip, getTooltip, hasEventProducer, hasFormatInformation, hasServerBindingChanged, hasVariables, internalGetRow, internalHasPermission, internalHasPermission, isArrayIteratorType, isAttributeMandatory, isAttributeUpdateable, isAttributeUpdateable, isAttributeUpdateable, isAttributeUpdateable, isEventsCachingEnabled, isNewInputValue, isNullInsertKeyPathForDCE, isPushOrPollDataChangeEvents, isViewable, lookupAttributeDef, notifyDataChangeEvent, notifyDataExceptionEvent, notifyDCE, pinDataControl, processInputException, removeAttrName, removeDataChangeListener, removeFromDCExceptions, resetInputState, resolvePath, restoreFromState, setArrayIteratorType, setAttribute, setAttribute, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeNames, setAttributes, setAttributeValue, setAttributeValuesInRow, setAttrViewExpressions, setError, setEventProducer, setEventsCaching, setInputValue, setInputValue, setInputValueHandler, setIteratorBinding, setListener, setNullValueString, startEvents, stopEditing, stopEvents, updateNavigated, updateRangeScrolled, updateRow, updateRowDeleted, updateRowInserted, useRowSpecificHints, validateInputValue
 
Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding
getCurrentRow, getFormBinding, getIteratorBinding, reportException, setFormBinding
 
Methods inherited from class oracle.adf.model.binding.DCControlBinding
addToDCExceptions, evaluateBooleanExpression, executeQuery, executeQueryIfNeeded, get, getAllRowsInRange, getApplicationModule, getAttributeListener, getBindingContainer, getControl, getDCIteratorBinding, getDef, getDefFullName, getDefName, getFullName, getLayoutObject, getName, getPermission, getPermissionTargetName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewableExpr, getViewObject, hashCode, internalSetName, isControlViewable, isReleased, needsEstimatedRowCount, release, reportException, resetAttributeExceptionInRow, setBindingContainer, setControl, setDataControlPinned, setListener, setName, setViewableExpr
 
Methods inherited from class oracle.jbo.common.JboAbstractMap
entrySet, equals, internalPut, 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
 
Methods inherited from interface oracle.adf.model.AttributeBinding
getErrors, getInputValue, getLabel, setInputValue, validateInputValue
 
Methods inherited from interface oracle.adf.model.ControlBinding
setListener
 
Methods inherited from interface oracle.binding.ControlBinding
getName, getPath, release, resolvePath, setListener
 
Methods inherited from interface oracle.jbo.StructureDef
getDefFullName, getDefName, getFullName, getName
 

Field Detail

comboButton

protected JUComboBoxLovEditButton comboButton

mLovPanel

protected JULovPanelInterface mLovPanel

NO_MATCH_VALUE

public static final java.lang.String NO_MATCH_VALUE
Constructor Detail

JUComboBoxLovEditBinding

public JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb,
                                JUIteratorBinding iterBinding,
                                java.lang.String[] attrNames,
                                int listOperMode,
                                boolean testMode,
                                boolean searchFlag)

JUComboBoxLovEditBinding

public JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb,
                                JUIteratorBinding iterBinding,
                                java.lang.String[] attrNames,
                                java.lang.Object[] valueList,
                                boolean testMode,
                                boolean searchFlag)
Binds a combobox to an attribute in the associated RowSet. The values displayed in combobox are provided by the valueList objects.

Parameters:
cb - ComboBox with which to associate this binding.
iterBinding - Provides the RowSet that is used to update current selection from the combobox 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 displayed as options in the combobox from which to select.

JUComboBoxLovEditBinding

protected JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb,
                                   DCIteratorBinding iterBinding,
                                   java.lang.String[] attrNames,
                                   java.lang.String lbName,
                                   boolean testMode,
                                   boolean searchFlag)
*** For internal framework use only ***


JUComboBoxLovEditBinding

public JUComboBoxLovEditBinding(JUComboBoxLovEditButton cb,
                                JUIteratorBinding iterBinding,
                                java.lang.String[] attrNames,
                                JUIteratorBinding listIterBinding,
                                java.lang.String[] listAttrNames,
                                java.lang.String[] listDisplayAttrNames,
                                boolean testMode,
                                boolean searchFlag)
Method Detail

getButtonModelImpl

protected javax.swing.ButtonModel getButtonModelImpl(javax.swing.AbstractButton button)
*** For internal framework use only ***


getControlModel

public java.lang.Object getControlModel(java.lang.Object control)
Description copied from class: JUComboBoxCtrlBinding
Gets the associated View's model object.

Overrides:
getControlModel in class JUComboBoxCtrlBinding

getControlCombo

protected javax.swing.JComboBox getControlCombo()
Overrides:
getControlCombo in class JUComboBoxCtrlBinding

getComboDisplayAttrs

protected AttributeDef[] getComboDisplayAttrs()
Overrides:
getComboDisplayAttrs in class JUComboBoxCtrlBinding

setupListItems

protected void setupListItems(boolean clean,
                              boolean keepSelectedIndex)
This method is used by the framwork to setup the list of values (LOV) that will be displayed in this LOV dialog.

Overrides:
setupListItems in class JUComboBoxCtrlBinding
Parameters:
clean - Controls whether to clean the existing entries in the combobox.
keepSelectedIndex - Controls 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 combobox, then the selection is reset to the first item.

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent evt)
Description copied from class: JUComboBoxCtrlBinding
Based on listOperMode, this binding either navigates the target rowset to the selected row or sets the attribute/attributes as based on the settings in the constructor.

Specified by:
actionPerformed in interface java.awt.event.ActionListener
Overrides:
actionPerformed in class JUComboBoxCtrlBinding

invokeLOVAction

public boolean invokeLOVAction()

performLOVAction

public void performLOVAction()
This method is invoked when action is to be performed on the associated button. It gets the current row from the LOV RowSet Iterator and update the values from this row in to the current row of the target RowSet Iterator by mapping each element in the lovAttributeNames[] in the source/LOV Row with each element in the attributeNames[] in the target Row.


setDimension

public void setDimension(java.awt.Dimension d)

setValueAt

public void setValueAt(java.lang.Object value,
                       int attrIndex)
Finds the item in the combobox that matches the given value and sets it as the current item.

Overrides:
setValueAt in class JUComboBoxCtrlBinding
Parameters:
value - This value is used in findMatchingListValue method to find out the item in the combobox that represents the given value. If the value is not found, then no item is selected in the list.
attrIndex - This argument is ignored by this method.

getIterBindingDefOptions

protected java.util.HashMap getIterBindingDefOptions(DCDataControl dc)
Overrides:
getIterBindingDefOptions in class JUCtrlListBinding

findMatchingListValue

public java.lang.Object findMatchingListValue(java.lang.Object val)
Overrides:
findMatchingListValue in class JUCtrlListBinding

getLovPanelInterface

public JULovPanelInterface getLovPanelInterface()

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1)

E10653-04

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