|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.cabo.ui.DeprecatedUINode | +--oracle.cabo.ui.BaseUINode | +--oracle.cabo.ui.BaseMutableUINode | +--oracle.cabo.ui.beans.BaseWebBean | +--oracle.cabo.ui.beans.MarlinBean | +--oracle.cabo.ui.beans.table.AddTableRowBean
This bean is not supported on the following agent types: pda.
The AddTableRowBean, when when used inside a TableBean,
will cause a special TableRow to be rendered which lets users click on a
button to add one or more rows of data. To use the AddTableRowBean, set it
as the columnFooter
child of the TableBean.
There are two customizations clients can make to the AddTableRowBean. First,
the text of the button can be customized. By default, the button will display
a localized version of the text "Add Another Row". However, after setting the
rows
property of the AddTableRowBean to a value
greater than one, the button will display the text "Add 'X' Row(s)" where 'X'
is the number of rows. If this is not satisfactory, clients can change the
button text altogether by setting the text
property to the desired text.
The other customization is the destination of the button when clicked. By default, the destination will use either form submission or URL arguments, depending on which is turned on in the parent table. If form submission is used, the AddTableRowBean will submit the table's form with an "event" form value set to "addRows", a "source" form value set to the name of the table, and a "size" form set to the number of rows to add. If URL argument links are used, the same three keys and values will be sent as parameters. See the TableBean documentation for more details.
If the standard destinations are not suitable, clients can override the
destination by setting the destination
property
of the AddTableRowBean to the desired value.
Finally, in the rare cases where a table needs the ability to add rows and
total columns as well, clients can use both an AddTableRowBean
and TotalRowBean
together. To do this, create and configure
both beans, then add the TotalRowBean
as an indexed child
of the AddTableRowBean
. Then add the
AddTableRowBean
as the columnFooter
child as usual.
<table ...> <columnFooter> <addTableRow/> </columnFooter> </table>
UIConstants
,
TableBean
,
TotalRowBean
Constructor Summary | |
|
AddTableRowBean()
Construct an instance of the AddTableRowBean. |
protected |
AddTableRowBean(boolean ignored,
java.lang.String localName)
Construct an instance of the AddTableRowBean. |
|
AddTableRowBean(int rows)
Construct an instance of the AddTableRowBean. |
|
AddTableRowBean(int rows,
java.lang.String destination)
Construct an instance of the AddTableRowBean. |
|
AddTableRowBean(java.lang.String text)
Construct an instance of the AddTableRowBean. |
|
AddTableRowBean(java.lang.String text,
java.lang.String destination)
Construct an instance of the AddTableRowBean. |
Method Summary | |
java.lang.String |
getDestination()
Gets the URI this button references. |
static java.lang.String |
getDestination(MutableUINode bean)
Gets the URI this button references. |
int |
getRows()
Gets the number of rows to be added. |
static int |
getRows(MutableUINode bean)
Gets the number of rows to be added. |
java.lang.String |
getText()
Gets the text to display in the button. |
static java.lang.String |
getText(MutableUINode bean)
Gets the text to display in the button. |
static void |
setDestination(MutableUINode bean,
java.lang.String destination)
Sets the URI this button references. |
void |
setDestination(java.lang.String destination)
Sets the URI this button references. |
void |
setRows(int rows)
Sets the number of rows to be added. |
static void |
setRows(MutableUINode bean,
int rows)
Sets the number of rows to be added. |
static void |
setText(MutableUINode bean,
java.lang.String text)
Sets the text to display in the button. |
void |
setText(java.lang.String text)
Sets the text to display in the button. |
static void |
setTranslatableText(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the text to display in the button. |
void |
setTranslatableText(java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the text to display in the button. |
Methods inherited from class oracle.cabo.ui.beans.MarlinBean |
isEqualMarlinName |
Methods inherited from class oracle.cabo.ui.BaseUINode |
getAttributeNames, getAttributeValue, getAttributeValueImpl, getChildArray, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getPreorderDescendentAttributeValue, getRawAttributeValue, getRenderedUINode, getRenderer, getRenderer, render, render, toString |
Methods inherited from class oracle.cabo.ui.DeprecatedUINode |
getAttributeValue, getChildNames, getNamedChild |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface oracle.cabo.ui.UINode |
getAttributeNames, getAttributeValue, getAttributeValue, getChildNames, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getRawAttributeValue, render, render |
Constructor Detail |
public AddTableRowBean()
public AddTableRowBean(int rows, java.lang.String destination)
rows
- the number of rows to be added.destination
- the URI this button references.public AddTableRowBean(java.lang.String text, java.lang.String destination)
text
- the text to display in the button.destination
- the URI this button references.public AddTableRowBean(int rows)
rows
- the number of rows to be added.public AddTableRowBean(java.lang.String text)
text
- the text to display in the button.protected AddTableRowBean(boolean ignored, java.lang.String localName)
Method Detail |
public final int getRows()
public final void setRows(int rows)
public final java.lang.String getText()
public final void setText(java.lang.String text)
public final void setTranslatableText(java.lang.String bundleName, java.lang.String key)
bundleName
- the name of the ResourceBundlekey
- the key of the string to retrieve from the ResourceBundlepublic final java.lang.String getDestination()
public final void setDestination(java.lang.String destination)
public static int getRows(MutableUINode bean)
public static void setRows(MutableUINode bean, int rows)
public static java.lang.String getText(MutableUINode bean)
public static void setText(MutableUINode bean, java.lang.String text)
public static void setTranslatableText(MutableUINode bean, java.lang.String bundleName, java.lang.String key)
bundleName
- the name of the ResourceBundlekey
- the key of the string to retrieve from the ResourceBundlepublic static java.lang.String getDestination(MutableUINode bean)
public static void setDestination(MutableUINode bean, java.lang.String destination)
|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |