oracle.jbo.uicli.jui
Class JULabelBinding

java.lang.Object
  |
  +--oracle.jbo.uicli.binding.JUControlBinding
        |
        +--oracle.jbo.uicli.binding.JUCtrlValueBinding
              |
              +--oracle.jbo.uicli.binding.JUCtrlAttrsBinding
                    |
                    +--oracle.jbo.uicli.jui.JULabelBinding

All Implemented Interfaces:

AttributeList

public class JULabelBinding

extends JUCtrlAttrsBinding

Binds a label control as a control binding so that the text for the label is derived from an attribute of a ViewObject row. This binding can be used to create dynamic UIs with labels read from the database using ViewObjects. JULabel is an example of a control that works with this binding.

Constructor Summary

protected	JULabelBinding()
	JULabelBinding(javax.swing.JLabel control, JUIteratorBinding iterBinding, java.lang.String attrName)

Method Summary

void	addControlToPanel(java.lang.Object panel, java.lang.Object layoutObject, java.lang.Object layoutCons) *** For internal framework use only ***
static JULabelBinding	createAttributeBinding(JUFormBinding formBinding, javax.swing.JLabel control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String attrName) This method is used by the JDeveloper design time wizards for binding a label with an attribute of rows of a ViewObject/RowIterator.
static JULabelBinding	getInstance(JUFormBinding formBinding, javax.swing.JLabel control, java.lang.String voInstanceName, java.lang.String voIterName, java.lang.String voIterBindingName, java.lang.String attrName) Deprecated. since JDeveloper 9.0.2, use createAttributeBinding instead
java.lang.Object	getValueAt(int attrIndex) Gets the value from the control for the attribute at the given index.
void	setDataValueAt(java.lang.Object value, int attrIndex)
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) Makes sure that labels are not turned into disabled if the attribute is marked readonly.

Methods inherited from class oracle.jbo.uicli.binding.JUCtrlAttrsBinding

refreshControl, updateNavigated, updateRangeScrolled, updateValuesFromRows

Methods inherited from class oracle.jbo.uicli.binding.JUCtrlValueBinding

findAttributeDef, getAttribute, getAttribute, getAttributeCount, getAttributeDef, getAttributeDefs, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeFromRow, getAttributeIndexOf, getAttributeNames, getAttributeValues, isArrayIteratorType, isAttributeUpdateable, setArrayIteratorType, setAttribute, setAttribute, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, setAttributeInRow, stopEditing, updateRowDeleted, updateRowInserted

Methods inherited from class oracle.jbo.uicli.binding.JUControlBinding

executeQuery, executeQueryIfNeeded, getAllRowsInRange, getApplicationModule, getControl, getCurrentRow, getDef, getFormBinding, getIteratorBinding, getLayoutObject, getName, getRowAtRangeIndex, getRowIterator, getTransaction, getViewObject, isControlQueriable, reportException, reportException, setFormBinding, setName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JULabelBinding

protected JULabelBinding()

JULabelBinding

public JULabelBinding(javax.swing.JLabel control,
JUIteratorBinding iterBinding,
                      java.lang.String attrName)

Method Detail

addControlToPanel

public void addControlToPanel(java.lang.Object panel,
                              java.lang.Object layoutObject,
                              java.lang.Object layoutCons)

*** For internal framework use only ***

Specified by:

addControlToPanel in class JUControlBinding

getValueAt

public java.lang.Object getValueAt(int attrIndex)

Description copied from class: JUCtrlAttrsBinding

Gets the value from the control for the attribute at the given index. (The index is calculated from the list of attributes this control binding is bound to as passed in the constructor). Framework uses this method to get the attribute value from the control and pass it on to the Row object on the BC4J side.

Specified by:

getValueAt in class JUCtrlAttrsBinding

setValueAt

public void setValueAt(java.lang.Object value,
                       int attrIndex)

Description copied from class: JUCtrlAttrsBinding

Updates the control/control-binding with the latest value of the attribute at the given index with the given value. This method is used by the framework to update the control with attribute values from a BC4J row.

Specified by:

setValueAt in class JUCtrlAttrsBinding

setDataValueAt

public void setDataValueAt(java.lang.Object value,
                           int attrIndex)

Specified by:

setDataValueAt in class JUCtrlAttrsBinding

updateValuesFromRow

public void updateValuesFromRow(Row row)

Makes sure that labels are not turned into disabled if the attribute is marked readonly. This method resets the control to it's existing enabled state.

Overrides:

updateValuesFromRow in class JUCtrlAttrsBinding

createAttributeBinding

public static JULabelBinding createAttributeBinding(JUFormBinding formBinding,
                                                    javax.swing.JLabel control,
                                                    java.lang.String voInstanceName,
                                                    java.lang.String voIterName,
                                                    java.lang.String voIterBindingName,
                                                    java.lang.String attrName)

This method is used by the JDeveloper design time wizards for binding a label with an attribute of rows of a ViewObject/RowIterator. This method calls JUFormBinding.getRowIterBinding to get the iterator binding using the given parameters and then registers a new JUTextFieldBinding with the iterator binding object so as to display/edit the current row's attribute of the given name.

Parameters:

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.

attrName - The name of the attribute of this ViewObject rows that contain data to display/edit in the associated text control.

Returns:

JULabelBinding An instance of control binding that works with the given label.

getInstance

public static JULabelBinding getInstance(JUFormBinding formBinding,
                                         javax.swing.JLabel control,
                                         java.lang.String voInstanceName,
                                         java.lang.String voIterName,
                                         java.lang.String voIterBindingName,
                                         java.lang.String attrName)

Deprecated. since JDeveloper 9.0.2, use createAttributeBinding instead