|
UIX 2.2.16 | ||||||||
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.form.FormElementBean | +--oracle.cabo.ui.beans.form.OptionContainerBean | +--oracle.cabo.ui.beans.form.ChoiceBean | +--oracle.cabo.ui.beans.form.LovChoiceBean
This bean is not supported on the following agent types: pda, phone, voice.
User interface popup choice element for list of values. The lovChoice control creates a menu-style control that allows the user to select a single value from a list of items. The lovChoice control contains all the options you specify and also appends an option called "More...". When the user presses the "More..." option, the List of Values modal window, as specified by the destination attribute, will open.
Selecting "More..." acts very much like selecting the flashlight icon of the lovInput element. For more details on the List of Values dialog and the events that fire as a result of selecting an item from the List of Values dialog, see the listOfValues element and the lovInput element. The lovChoice should be used instead of lovInput when there is a high likelihood that users will choose among only a small set of values. The user can select one of the options or the user can choose "More..." to select from the List of Values. Follow the BLAF guidelines when data-binding the options. The BLAF says that the user's selection from the List of Values modal window should be appended to the options. It has rules that should be followed, such as limits to the number of options in the lovChoice. Just like the choice element, the lovChoice element has an attribute called primaryClientAction. Use this to trigger a client-side action when an option is selected. Use firePartialAction to fire a partial page refresh event and use fireAction to submit the form in full page mode. firePartialAction defaults to fireAction if PPR is not enabled.<flowLayout id="lovChoiceFlowLayoutID"> <contents> <lovChoice name="lovChoiceName" destination="LOVChoiceDemoDlg.uix" selectedValue="${sessionScope.selectedValue}"> <contents childData="${sessionScope.userData}"> <option text="${uix.current.location}" value="${uix.current.location}"/> </contents> <primaryClientAction> <firePartialAction targets="selectedValueTextID lovChoiceFlowLayoutID" event="lovChoiceUpdate"/> </primaryClientAction> </lovChoice> </contents> </flowLayout> <messageStyledText prompt="The location you have chosen is:" id="selectedValueTextID" text="${sessionScope.userData.location}"/>
Constructor Summary | |
|
LovChoiceBean()
Construct an instance of the LovChoiceBean. |
protected |
LovChoiceBean(boolean ignored,
java.lang.String localName)
Construct an instance of the LovChoiceBean. |
|
LovChoiceBean(java.lang.String name)
Construct an instance of the LovChoiceBean. |
Method Summary | |
java.lang.String |
getDestination()
Gets The path to the List Of Values modal window. |
static java.lang.String |
getDestination(MutableUINode bean)
Gets The path to the List Of Values modal window. |
java.lang.String |
getOnLovInit()
Gets The name of a JavaScript function that will be called before the LOV window is opened. |
static java.lang.String |
getOnLovInit(MutableUINode bean)
Gets The name of a JavaScript function that will be called before the LOV window is opened. |
java.lang.String |
getOnLovSelect()
Gets The name of a JavaScript function that will be called after the LOV window is closed. |
static java.lang.String |
getOnLovSelect(MutableUINode bean)
Gets The name of a JavaScript function that will be called after the LOV window is closed. |
boolean |
isFormSubmitted()
Gets Controls the delivery of the LOV events. |
static boolean |
isFormSubmitted(MutableUINode bean)
Gets Controls the delivery of the LOV events. |
static void |
setDestination(MutableUINode bean,
java.lang.String destination)
Sets The path to the List Of Values modal window. |
void |
setDestination(java.lang.String destination)
Sets The path to the List Of Values modal window. |
void |
setFormSubmitted(boolean formSubmitted)
Sets Controls the delivery of the LOV events. |
static void |
setFormSubmitted(MutableUINode bean,
boolean formSubmitted)
Sets Controls the delivery of the LOV events. |
static void |
setOnLovInit(MutableUINode bean,
java.lang.String onLovInit)
Sets The name of a JavaScript function that will be called before the LOV window is opened. |
void |
setOnLovInit(java.lang.String onLovInit)
Sets The name of a JavaScript function that will be called before the LOV window is opened. |
static void |
setOnLovSelect(MutableUINode bean,
java.lang.String onLovSelect)
Sets The name of a JavaScript function that will be called after the LOV window is closed. |
void |
setOnLovSelect(java.lang.String onLovSelect)
Sets The name of a JavaScript function that will be called after the LOV window is closed. |
Methods inherited from class oracle.cabo.ui.beans.form.ChoiceBean |
getPrimaryClientAction, getPrimaryClientAction, getRequired, getRequired, setPrimaryClientAction, setPrimaryClientAction, setRequired, setRequired |
Methods inherited from class oracle.cabo.ui.beans.form.FormElementBean |
getName, getName, getOnBlur, getOnBlur, getOnFocus, getOnFocus, isDisabled, isDisabled, isReadOnly, isReadOnly, setDisabled, setDisabled, setName, setName, setNameBinding, setNameBinding, setNameBinding, setNameBinding, setNameBinding, setNameBinding, setOnBlur, setOnBlur, setOnFocus, setOnFocus, setReadOnly, setReadOnly |
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 LovChoiceBean()
public LovChoiceBean(java.lang.String name)
name
- the name used to identify the element in client-to-client or
client-to-server events.protected LovChoiceBean(boolean ignored, java.lang.String localName)
Method Detail |
public final java.lang.String getDestination()
public final void setDestination(java.lang.String destination)
public final java.lang.String getOnLovInit()
function initCallBack(params)
public final void setOnLovInit(java.lang.String onLovInit)
function initCallBack(params)
public final java.lang.String getOnLovSelect()
function selectCallBack(Win, field, event)
public final void setOnLovSelect(java.lang.String onLovSelect)
function selectCallBack(Win, field, event)
public final boolean isFormSubmitted()
public final void setFormSubmitted(boolean formSubmitted)
public static java.lang.String getDestination(MutableUINode bean)
public static void setDestination(MutableUINode bean, java.lang.String destination)
public static java.lang.String getOnLovInit(MutableUINode bean)
function initCallBack(params)
public static void setOnLovInit(MutableUINode bean, java.lang.String onLovInit)
function initCallBack(params)
public static java.lang.String getOnLovSelect(MutableUINode bean)
function selectCallBack(Win, field, event)
public static void setOnLovSelect(MutableUINode bean, java.lang.String onLovSelect)
function selectCallBack(Win, field, event)
public static boolean isFormSubmitted(MutableUINode bean)
public static void setFormSubmitted(MutableUINode bean, boolean formSubmitted)
|
UIX 2.2.16 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |