oracle.cabo.ui.beans.templates
Class ListOfValuesBean

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.templates.ListOfValuesBean

All Implemented Interfaces:

MutableUINode, UIConstants, UINode

public class ListOfValuesBean

extends MarlinBean

The listOfValues element describes the contents of a LOV dialog window. The window follows the layout defined in the BLAF List Of Values template version 2.1. This element is designed to work with the lovInput element.

The listOfValues element defines a layout which displays a category choice, a search text field, and a table which together allow the user to choose appropriate values. This element is designed to be called from an lovInput node, which will display it in a modal window.

The listOfValues element accepts an arbitrary UINode as it's content. The only legal visible contents of this element is a proxied, form-submitted table. This table shoule display all valid values based on the current searchText. All management of the table is left up to the developer. The listOfValues merely displays the table as provided. If tracking of more information is desired, the developer may supply one or more formValue elements (hidden fields) along with the Table.

When the LOV window opens, the user is presented with a table of prospective completions based on their originally entered text. The user may choose to cancel (in which case the original lovInput field should remain unchanged), select one or several of the rows presented, navigate to other rows in the table, search on another category, or enter new search string/filter criteria.

The LOV window presents a search block which allows the user to set the parameters of their search. This block contains a short description, possibly a categories choice, a textInput field, and a 'Go' button. When the 'Go' button is clicked, an lovFilter event is generated with all form elements, but only two parameters of real interest:

• searchText is the value or partial value being searched for. It should be used to filter the dataset used to build the LOV table
• <choiceelementname> This parameter names the selected option of the filterChoice named child element.

Once the LOV dialog window is displayed, the end user can do one of eight things:

• Change the search filter category (using the filterChoice pulldown)
• Edit the search filter text
• Select/deselect one or more of the displayed table rows
• Click the "Go" button
• Perform a table operation (e.g. navigate to another rowset if the dataset has more rows than will display in one page of the table).
• Click the "Select" button
• Click the "Cancel" button
• Close the LOV window.

Only the last five actions will generate events to the server. All of these events will contain any provided hidden fields as parameters. Every event will also have the following parameters:

• <choiceelementname> This parameter names the selected option of the filterChoice named child element. The actual parameter name that comes back with the submission is the name attribute of the choice element defined as the filterChoice named child.
• searchText is the value or partial value being searched for.

In addition, every event will get the normal table related parameters such as value, size, <tableName>:length, <tableName>:selectMode, and possibly <tableName>:selected:<selectionNumber>. However, these table parameters should be ignored when processing the "Go" button's lovFilter event.

The five events have the following effects:

• "Go" button: an lovFilter event is generated. All table parameters and hidden fields are provided. No additional useable parameters are sent. The client should update the table row data provider based on the searchText and <choiceelementname> parameters.
• Table operation: There is nothing LOV-specific about the table. It can generate any event that any other table can.

• "Select" button: an lovSelect event is generated. All table parameters and hidden fields are provided. The source parameter will provide the element ID attribute. The user is done, the client must update gather and store all remaining selection information.

  After the lovSelect event is queued, the LOV window will be closed. On closing, the lovWindow will send an lovUpdate event. This event tells the developer that the LOV window has gone away, and it's time to update all data providers. This event submits the form on the main page in which the original LovInput element was drawn. The source parameter will contain the name attribute of the original lovInput element.

• "Cancel" button or window close: The LOV window is closed. No further events are generated. The lovInput field should remain unchanged.

A typical usage scenario would go something like the following. Again, the listOfValues element is designed to work with the lovInput element. This usage scenario explains steps taken in response to attributes on both elements.

• The user alters the lovInput text field and clicks the search icon.
• The onLovValidate callback fires. Clients can add/delete/update any of the parameters that will go on the validation URL. If the user clicks the search icon without changing the text, the LOV window will be brought up directly without an onLovValidate event.
• If onLovValidate returns false, we go back to the main page with no changes.
• Otherwise the lovValidate event is sent to the server. The event will have two parameters. The source parameter will contain the name of the lovInput element, and searchText will contain the data from the text input field of the lovInput. The URL used to send this event will include any parameters the client added or changed in the onLovValidate callback.
• The lovValidate handler does a preliminary check and sets the lovInput's "showWindow" attribute data provider to return true or false.
• If the "showWindow" attribute is set to false, then the main page is re-drawn (presumably with values updated in the lovValidate event handler), no LOV window is raised.
• If the "showWindow" attribute is set to true, then a javascript call is sent down which calls the open LOV Window function in the LovInput.
• If an onLovInit callback has been provided, it is called. It has the same interface as onLovValidate. The client can add/delete/update any parameters that will go on the LOV window URL.
• The LOV Window is opened with the URL provided as the destination attribute to the lovInput element, and any parameters you may have added in the onLovInit callback. The LOV window has a main table section in the form. This is the indexed child of the listOfValues element. The contents can be an arbitrary UINode, but the only visible element must be a table. You can add hidden fields here, and they will come back on any button press or table operation.
• The user clicks Select, and the lovSelect event is fired. The handler for this event should update any providers.
• If the user clicks Cancel or closes the window, no event will be fired, no redraw will take place. All values should remain what they were prior to the LOV window opening.
• The LOV window is closed, the lovUpdate event is fired. The lovUpdate handler should do any cleanup needed. If the client has any dependent fields that need to be re-drawn along with the main lovInput field, they should be added to the list of partial targets in the lovUpdate handler (only in a partial page update environment).
• The main window is re-drawn using the updated values.

The validation step can be skipped entirely by returning false from the onLovValidate callback, or setting the unvalidated attribute to false. Similarly, the client can stop the LOV window from opening by returning false from the onLovInit callback.

Any main page re-draws are done with a partial page refresh.

In the non-partial-page world, no pre-validation is done, and the user has to explicitly click the search icon (there is no onChange event handler). All main page re-draws are full re-draws.

Example:

 
 <listOfValues data:searchText="searchText@lov1@LOV:mappedData"
               title="LOV field #1">
  <headerInstructions>
   <styledText text="Header instruction text"
               styleClass="OraInstructionText"/>
  </headerInstructions>
 
    <!-- This choice just pulls out the column headers  -->
  <filterChoice>
    <choice name="categoryChoice"
            multiple="false"
            data:selectedValue="categoryChoice@LOV:generalParams">
     <contents data:childData="category@LOV:categoryData">
      <option data:text="catText"/>
     </contents>
    </choice>
   </filterChoice>
  <searchInstructions>
   <styledText text="Instruction text for the search area "
               styleClass="OraInstructionText"/>
  </searchInstructions>
 
  <contents>
   <flowLayout>
    <contents>
     <formValue name="hiddenA" value="valA"/>
     <formValue name="hiddenB" value="valB"/>
 
     <!-- Here's the table definition                             -->
     <table name="valuesTable1"
            width="80%"
            minValue="1"
            data:maxValue="max@LOV:tableParams"
            data:value="start@LOV:tableParams"
            data:blockSize="size@LOV:tableParams"
            data:alternateText="alternateText@LOV:tableParams"
            data:tableData="row@LOV:tableData"
            formSubmitted="true"
            proxied="true">
      <columnHeaderStamp>
       <boundText select="hdrText"/>
      </columnHeaderStamp>
      <boundAttribute name="columnHeaderData">
       <dataObject select="header"
                   source="LOV:headerData"/>
      </boundAttribute>
      <tableSelection>
       <multipleSelection text="select an item"
                          data:selected="selected"/>
      </tableSelection>
       <contents>
        <!-- Populate with some sample data                -->
        <boundText select="C1Dat"/>
        <boundText select="C2Dat"/>
        <boundText select="rowid"/>
        <boundText select="AttrDat"/>
       </contents>
     </table>
    </contents>
   </flowLayout>
  </contents>
 </listOfValues>

Fields inherited from interface oracle.cabo.ui.UIConstants

ABOUT_CHILD, ACCESS_KEY_ATTR, ADD_NAME, ADD_ROWS_EVENT, ADD_TABLE_ROW_NAME, AGENT_NAME, ALL_DETAILS_ENABLED_ATTR, ALTERNATE_CONTENT_CHILD, ALTERNATE_TEXT_ATTR, ANCESTOR_ATTRIBUTE_NAME, ANCESTOR_ID_ATTR, ANCESTOR_PATH_ATTR, ANCHOR_ATTR, AND_NAME, APPLICATION_SWITCHER_NAME, ARRAY_NODE_LIST_NAME, ATTRIBUTE_MAP_NAME, AUTOFLIP_ATTR, AUTOMATIC_ATTR, AUTOSTART_ATTR, BACKGROUND_ATTR, BACKGROUND_DARK, BACKGROUND_LIGHT, BACKGROUND_MEDIUM, BANDING_INTERVAL_KEY, BANDING_SHADE_DARK, BANDING_SHADE_KEY, BANDING_SHADE_LIGHT, BEAN_NAME, BETWEEN_TEXT_ATTR, BLOCK_SIZE_ATTR, BODY_NAME, BORDER_LAYOUT_NAME, BORDER_WIDTH_ATTR, BOTTOM_CHILD, BOUND_ATTRIBUTE_NAME, BOUND_MESSAGE_NAME, BOUND_TEXT_NAME, BOUND_VALUE_PROVIDER_NAME, BREAD_CRUMBS_NAME, BROWSE_EVENT, BROWSE_MENU_NAME, BULLETED_LIST_NAME, BUNDLE_NAME, BUTTON_NAME, BYTE_LENGTH_NAME, CALENDAR_NAME, CANCEL_EVENT, CASE_NAME, CATCH_CHILD, CATEGORIES_CHILD, CATEGORY_TITLE_ATTR, CELL_FORMAT_NAME, CELL_NO_WRAP_FORMAT_KEY, CELL_PADDING_ATTR, CELL_SPACING_ATTR, CENTER_CHILD, CHECK_BOX_NAME, CHECKED_ATTR, CHILD_DATA_ATTR, CHILD_LIST_NAME, CHILD_MAP_NAME, CHILD_NAME_ATTR, CHOICE_NAME, COBRANDING_CHILD, COLLAPSE_ALL_EVENT, COLLAPSE_DESTINATION_KEY, COLUMN_BANDING, COLUMN_DATA_FORMAT_KEY, COLUMN_FOOTER_CHILD, COLUMN_FORMAT_ATTR, COLUMN_FORMATS_ATTR, COLUMN_GROUP_NAME, COLUMN_HEADER_CHILD, COLUMN_HEADER_DATA_ATTR, COLUMN_HEADER_FORMAT_ATTR, COLUMN_HEADER_FORMATS_ATTR, COLUMN_HEADER_STAMP_CHILD, COLUMN_NAME, COLUMN_SPAN_ATTR, COLUMNS_ATTR, COMPARISON_NAME, COMPARISON_TYPE_EQUALS, COMPARISON_TYPE_GREATER_THAN, COMPARISON_TYPE_GREATER_THAN_OR_EQUALS, COMPARISON_TYPE_LESS_THAN, COMPARISON_TYPE_LESS_THAN_OR_EQUALS, COMPARISON_TYPE_NOT_EQUALS, COMPOSITE_ROLE, CONCAT_NAME, CONCISE_MESSAGE_CHILD, CONSUMER_NAME, CONTENT_CONTAINER_NAME, CONTENT_FOOTER_CHILD, CONTENT_FOOTER_NAME, CONTENT_FORM_CHILD, CONTENT_LINK_CHILD, CONTENT_STYLE_CLASS_ATTR, CONTENT_TYPE_ATTR, CONTENTS_NAME, CONTEXT_POPPING_NAME, CONTEXT_PROPERTY_NAME, CONTEXT_SWITCHER_CHILD, CONTROLS_ALL, CONTROLS_ATTR, CONTROLS_MINIMAL, CONTROLS_NONE, CONTROLS_NONE_VISIBLE, CONTROLS_TYPICAL, COPYRIGHT_CHILD, CORPORATE_BRANDING_CHILD, CURRENT_DATA_ATTR, CURRENT_THROWABLE_PROPERTY, DATA_KEY, DATA_NAME, DATA_NAME_ATTR, DATA_NAMESPACE_ATTR, DATA_OBJECT_NAME, DATA_SCOPE_NAME, DATE_BUTTON_NAME, DATE_EVENT, DATE_FIELD_NAME, DATE_FORMAT_NAME, DATE_NAME, DECIMAL_NAME, DEFAULT_CASE_ATTR, DEFAULT_CONTENTS_ATTR, DEFAULT_NAME, DEFAULTING_NAME, DESCRIPTION_KEY, DESTINATION_ATTR, DESTINATION_KEY, DESTINATION_TEXT_KEY, DETAIL_CHILD, DETAIL_DISCLOSURE_ATTR, DETAIL_SELECTOR_NAME, DETAILED_MESSAGE_CHILD, DIRECTION_ATTR, DIRTY_ATTR, DISABLED_ATTR, DISCLOSED_ATTR, DISCLOSED_KEY, DISCLOSED_TEXT_ATTR, DISPLAY_EXCEPTION_NAME, DISPLAY_GRID_KEY, DOCUMENT_NAME, ENCODED_PARAMETER_NAME, END_CHILD, EVENT_PARAM, EXCEPTIONS_CAUGHT_PROPERTY, EXPAND_ALL_EVENT, EXPAND_DESTINATION_KEY, EXPAND_EVENT, EXPANDABLE_COLLAPSED, EXPANDABLE_EXPANDED, EXPANDABLE_KEY, EXPANDABLE_NO, FACET_DEFAULT, FACET_EMAIL, FACET_PORTLET, FACET_PRINTABLE, FIELD_WIDTH_ATTR, FILE_UPLOAD_NAME, FILTER_CHILD, FILTER_CHOICE_CHILD, FIXED_NAME, FLOW_LAYOUT_NAME, FOCUS_EVENT, FOOTER_NAME, FOOTNOTE_CHILD, FORM_DATA_ATTR, FORM_NAME, FORM_NAME_ATTR, FORM_NAME_PROPERTY, FORM_PARAMETER_NAME, FORM_SUBMITTED_ATTR, FORM_VALUE_NAME, FORMAT_NAME, FORMATTED_TEXT_NAME, FRAME_BORDER_LAYOUT_NAME, FRAME_NAME, GENERATES_CONTENT_ATTR, GLOBAL_BUTTON_BAR_NAME, GLOBAL_BUTTON_NAME, GLOBAL_BUTTONS_CHILD, GLOBAL_HEADER_NAME, GOTO_EVENT, H_ALIGN_ATTR, H_ALIGN_CENTER, H_ALIGN_END, H_ALIGN_LEFT, H_ALIGN_RIGHT, H_ALIGN_START, H_GRID_NAME, HARD_WRAP, HEAD_NAME, HEADER_INSTRUCTIONS_CHILD, HEADER_NAME, HEADERS_ATTR, HEIGHT_ATTR, HIDE_EVENT, HIDE_SHOW_HEADER_NAME, HIDE_SHOW_NAME, ICON_ATTR, ICON_BUTTON_FORMAT, ICON_KEY, ID_ATTR, IF_NAME, IMAGE_ATTR, IMAGE_MAP_TYPE_ATTR, IMAGE_MAP_TYPE_NONE, IMAGE_MAP_TYPE_SERVER, IMAGE_NAME, IMPORT_SCRIPT_NAME, INCLUDE_NAME, INLINE_MESSAGE_NAME, INLINE_NAME, INLINE_STYLE_ATTR, INNER_BOTTOM_CHILD, INNER_END_CHILD, INNER_HEIGHT_ATTR, INNER_LEFT_CHILD, INNER_RIGHT_CHILD, INNER_START_CHILD, INNER_TOP_CHILD, INNER_WIDTH_ATTR, INSERTED_NODE_LIST_NAME, INSTANCE_NAME, ITEM_TITLE_ATTR, ITEMS_CHILD, LABEL_CHILD, LABEL_WIDTH_ATTR, LABELED_FIELD_LAYOUT_NAME, LABELED_NODE_ID_ATTR, LANGUAGE_ATTR, LARGE_ADVERTISEMENT_CHILD, LEADING_CHILD, LEADING_DESC_SHOWN_ATTR, LEADING_FOOTER_CHILD, LEADING_HEADER_ATTR, LEFT_CHILD, LINK_NAME, LIST_NAME, LIST_OF_VALUES_NAME, LIST_STYLE_ATTR, LIST_STYLE_CIRCLE, LIST_STYLE_DECIMAL, LIST_STYLE_DISC, LIST_STYLE_LOWER_ALPHA, LIST_STYLE_NONE, LIST_STYLE_SQUARE, LIST_STYLE_UPPER_ALPHA, LOCATION_CHILD, LOCATION_PARAM, LONG_DESC_ATTR, LONG_DESC_URL_ATTR, LOV_EVENT, LOV_FIELD_NAME, LOV_FILTER_EVENT, LOV_INPUT_NAME, LOV_LIBRARY_NAME, LOV_SEARCH_TEXT, MAILTO_NAME, MARLIN_NAMESPACE, MAX_VALUE_ATTR, MAX_VALUE_UNKNOWN, MAX_VISITED_ATTR, MAXIMUM_LENGTH_ATTR, MEDIA_NAME, MEDIUM_ADVERTISEMENT_CHILD, MESSAGE_ATTR, MESSAGE_BOX_NAME, MESSAGE_CHECK_BOX_NAME, MESSAGE_CHOICE_NAME, MESSAGE_DATE_FIELD_NAME, MESSAGE_FILE_UPLOAD_NAME, MESSAGE_FORMAT_NAME, MESSAGE_LIST_NAME, MESSAGE_LOV_FIELD_NAME, MESSAGE_LOV_INPUT_NAME, MESSAGE_PROMPT_NAME, MESSAGE_RADIO_BUTTON_NAME, MESSAGE_RADIO_GROUP_NAME, MESSAGE_STYLED_TEXT_NAME, MESSAGE_TEXT_INPUT_NAME, MESSAGE_TEXT_NAME, MESSAGE_TYPE_ATTR, MESSAGE_TYPE_CONFIRMATION, MESSAGE_TYPE_ERROR, MESSAGE_TYPE_INFO, MESSAGE_TYPE_NONE, MESSAGE_TYPE_PROCESSING, MESSAGE_TYPE_WARNING, MESSAGES_CHILD, META_CONTAINER_CHILD, METHOD_ATTR, METHOD_NAME, MIN_VALUE_ATTR, MINIMUM_WIDTH_ATTR, MULTIPLE_ATTR, MULTIPLE_SELECTION_NAME, NAME_ATTR, NAME_TRANSFORMED_ATTR, NAME_VALUES_ATTR, NAMED_SOURCE_ATTR, NAMES_ATTR, NAVIGATE_EVENT, NAVIGATION_BAR_NAME, NAVIGATION_FORM_NAME_ATTR, NO_BANDING, NODE_ATTR, NODE_PARAM, NODE_STAMP_CHILD, NODES_ATTR, NODES_KEY, NOT_NAME, NUMBER_FORMAT, ON_BLUR_ATTR, ON_BLUR_VALIDATER_ATTR, ON_CHANGE_ATTR, ON_CLICK_ATTR, ON_CLICK_KEY, ON_DOUBLE_CLICK_ATTR, ON_FOCUS_ATTR, ON_KEY_DOWN_ATTR, ON_KEY_PRESS_ATTR, ON_KEY_UP_ATTR, ON_LOAD_ATTR, ON_LOV_INIT_ATTR, ON_LOV_SELECT_ATTR, ON_LOV_VALIDATE_ATTR, ON_MOUSE_DOWN_ATTR, ON_MOUSE_MOVE_ATTR, ON_MOUSE_OUT_ATTR, ON_MOUSE_OVER_ATTR, ON_MOUSE_UP_ATTR, ON_NAVIGATE_ATTR, ON_SELECT_ATTR, ON_SUBMIT_ATTR, ON_SUBMIT_VALIDATER_ATTR, ON_SWITCH_APP_ATTR, ON_UNLOAD_ATTR, OPTION_NAME, OR_NAME, ORIENTATION_ATTR, ORIENTATION_BOTTOM, ORIENTATION_DEFAULT, ORIENTATION_HORIZONTAL, ORIENTATION_TOP, ORIENTATION_VERTICAL, PAGE_BUTTON_BAR_NAME, PAGE_BUTTONS_CHILD, PAGE_HEADER_CHILD, PAGE_HEADER_LAYOUT_NAME, PAGE_LAYOUT_NAME, PAGE_STATUS_CHILD, PARSE_NAME, PARTIAL_CONTENT_NAME, PARTIAL_LINK_NAME, PARTIAL_NODE_ID_ATTR, PARTIAL_PAGE_CONTEXT_PROPERTY, PARTIAL_PARAM, PARTIAL_RENDER_ENABLED_ATTR, PARTIAL_RENDER_MODE_ATTR, PARTIAL_RENDER_MODE_MULTIPLE, PARTIAL_RENDER_MODE_NONE, PARTIAL_RENDER_MODE_SELF, PARTIAL_ROOT_NAME, PARTIAL_SUBMIT_BUTTON_NAME, PARTIAL_TARGET_IDS_ATTR, PARTIAL_TARGETS_ATTR, PARTIAL_TARGETS_PARAM, PERCENT_COMPLETE_ATTR, PERCENT_UNKNOWN, PLAY_COUNT_ATTR, PLAYER_ATTR, PLAYER_LINK, PLAYER_QUICKTIME, PLAYER_REAL, PLAYER_WINDOWS, PORTLET_NAME, POST_TEXT_ATTR, PRE_TEXT_ATTR, PRIMARY_CLIENT_ACTION_ATTR, PRIVACY_CHILD, PROCESS_STEPS_NAME, PROCESSING_LAYOUT_NAME, PROCESSING_NAME, PRODUCT_BRANDING_CHILD, PRODUCT_BRANDING_NAME, PROMPT_ATTR, PROMPT_CHILD, PROVIDER_ATTR, PROXIED_ATTR, PROXY_ATTR, QUICK_LINKS_NAME, QUICK_LINKS_SHOWN_ATTR, QUICK_SEARCH_CHILD, RADIO_BUTTON_NAME, RADIO_GROUP_NAME, RADIO_GROUP_TYPE_CHOICE, RADIO_GROUP_TYPE_RADIO, RADIO_OPTION_NAME, RADIO_SET_NAME, RAW_TEXT_NAME, READ_ONLY_ATTR, REFRESH_EVENT, REG_EXP_NAME, RENDERED_ATTR, REORDERABLE_ATTR, REQUIRED_ATTR, REQUIRED_NO, REQUIRED_UI_ONLY, REQUIRED_VALIDATER_ONLY, REQUIRED_YES, RESET_BUTTON_NAME, RETURN_NAVIGATION_CHILD, RIGHT_CHILD, ROOT_ATTRIBUTE_MAP_NAME, ROOT_CHILD_EXISTS_NAME, ROOT_CHILD_LIST_NAME, ROOT_CHILD_MAP_NAME, ROOT_CHILD_NAME, ROOT_PARAM, ROW_BANDING, ROW_FORMATS_ATTR, ROW_HEADER_DATA_ATTR, ROW_HEADER_FORMATS_ATTR, ROW_HEADER_STAMP_CHILD, ROW_LAYOUT_NAME, ROW_SPAN_ATTR, ROWS_ATTR, SAMPLE_NAME, SCRIPT_NAME, SCROLLED_VALUE_ATTR, SCROLLING_ATTR, SCROLLING_AUTO, SCROLLING_NO, SCROLLING_YES, SEARCH_INSTRUCTIONS_CHILD, SEARCH_TEXT_ATTR, SECRET_ATTR, SELECT_ATTR, SELECTED_ATTR, SELECTED_INDEX_ATTR, SELECTED_KEY, SELECTED_VALUE_ATTR, SELECTION_ATTR, SELECTION_PARAM, SEPARATOR_CHILD, SEPARATOR_NAME, SERVER_VALIDATER_ATTR, SERVLET_INCLUDE_NAME, SHORT_DESC_ATTR, SHORT_TEXT_ATTR, SHOW_ALL_ACTIVE, SHOW_ALL_ATTR, SHOW_ALL_NO, SHOW_ALL_YES, SHOW_EVENT, SHOW_WINDOW_ATTR, SHUTTLE_NAME, SIDE_BAR_NAME, SIDE_NAV_NAME, SINGLE_SELECTION_NAME, SINGLE_STEP, SIZE_ATTR, SIZE_PARAM, SLIM_ATTR, SOFT_WRAP, SORT_EVENT, SORT_STATE_ASCENDING, SORT_STATE_DESCENDING, SORTABLE_ASCENDING, SORTABLE_ATTR, SORTABLE_DESCENDING, SORTABLE_HEADER_NAME, SORTABLE_NO, SORTABLE_YES, SOURCE_ATTR, SOURCE_PARAM, SPACER_NAME, STACK_LAYOUT_NAME, STANDBY_TEXT_ATTR, START_CHILD, STATE_PARAM, STATE_ROLE, STEPS_COMPLETE_ATTR, STRUCTURAL_ROLE, STYLE_CLASS_ATTR, STYLE_SHEET_NAME, STYLED_ITEM_NAME, STYLED_LIST_NAME, STYLED_TEXT_NAME, SUB_TAB_BAR_NAME, SUB_TAB_LAYOUT_NAME, SUB_TABS_CHILD, SUBMIT_BUTTON_NAME, SUMMARY_ATTR, SWITCH_APP_EVENT, SWITCH_APP_TYPE_BACK, SWITCH_APP_TYPE_GOTO, SWITCHER_NAME, TAB_BAR_NAME, TABLE_BANDING_KEY, TABLE_DATA_ATTR, TABLE_FILTER_CHILD, TABLE_FORMAT_ATTR, TABLE_LAYOUT_NAME, TABLE_NAME, TABLE_NAME_ATTR, TABLE_SELECTION_CHILD, TABS_CHILD, TARGET_FRAME_ATTR, TARGET_FRAME_KEY, TEMPLATE_DEFINITION_NAME, TEMPLATE_IMPORT_NAME, TEMPLATE_LIBRARY_NAME, TEMPLATES_NAME, TEXT_ATTR, TEXT_FORMAT, TEXT_INPUT_NAME, TEXT_KEY, TEXT_NAME, THREADED_ATTR, THREADED_LAYOUT_NAME, TIME_INTERVAL_ATTR, TIP_ATTR, TIP_NAME, TITLE_ATTR, TOP_CHILD, TOTAL_ROW_NAME, TRAILING_CHILD, TRAILING_DESC_SHOWN_ATTR, TRAILING_FOOTER_CHILD, TRAILING_HEADER_ATTR, TRAIN_NAME, TREE_DATA_ATTR, TREE_NAME, TRY_NAME, TYPE_ATTR, TYPE_PARAM, TYPE_POST, TYPE_PRE, TYPE_TEXT_ATTR, UNDISCLOSED_TEXT_ATTR, UNKNOWN_ROLE, UNVALIDATED_ATTR, UPDATE_EVENT, URI_PARAM, URL_INCLUDE_NAME, USER_INFO_CHILD, USER_INVISIBLE_ROLE, USES_UPLOAD_ATTR, UTF8_LENGTH_NAME, V_ALIGN_ABSMIDDLE, V_ALIGN_ATTR, V_ALIGN_BOTTOM, V_ALIGN_MIDDLE, V_ALIGN_TOP, VALID_ATTR, VALIDATE_BLANKS_ATTR, VALUE_ATTR, VALUE_COLUMNS_ATTR, VALUE_PARAM, VALUE_SHOW_ALL, WIDTH_ATTR, WIDTH_KEY, WML_NAME, WRAP_ATTR, WRAPPING_DISABLED_ATTR

Constructor Summary

	ListOfValuesBean() Construct an instance of the ListOfValuesBean.
protected	ListOfValuesBean(boolean ignored, java.lang.String localName) Construct an instance of the ListOfValuesBean.

Method Summary

java.lang.String	getDestination() Gets The URL to which the form will be submitted.
static java.lang.String	getDestination(MutableUINode bean) Gets The URL to which the form will be submitted.
UINode	getFilterChoice() This choice node should list all the table headers by which a user could search for their desired value.
static UINode	getFilterChoice(MutableUINode bean) This choice node should list all the table headers by which a user could search for their desired value.
UINode	getHeaderInstructions() A short instructional text which will display in the header block of the LOV window.
static UINode	getHeaderInstructions(MutableUINode bean) A short instructional text which will display in the header block of the LOV window.
UINode	getSearchInstructions() A short instructional text which will display in the search block of the LOV window.
static UINode	getSearchInstructions(MutableUINode bean) A short instructional text which will display in the search block of the LOV window.
java.lang.String	getSearchText() Gets The string that is being searched on.
static java.lang.String	getSearchText(MutableUINode bean) Gets The string that is being searched on.
java.lang.String	getTitle() Gets Identifies the field to which this list of values applies.
static java.lang.String	getTitle(MutableUINode bean) Gets Identifies the field to which this list of values applies.
static void	setDestination(MutableUINode bean, java.lang.String destination) Sets The URL to which the form will be submitted.
void	setDestination(java.lang.String destination) Sets The URL to which the form will be submitted.
static void	setFilterChoice(MutableUINode bean, UINode filterChoiceNode) This choice node should list all the table headers by which a user could search for their desired value.
void	setFilterChoice(UINode filterChoiceNode) This choice node should list all the table headers by which a user could search for their desired value.
static void	setHeaderInstructions(MutableUINode bean, UINode headerInstructionsNode) A short instructional text which will display in the header block of the LOV window.
void	setHeaderInstructions(UINode headerInstructionsNode) A short instructional text which will display in the header block of the LOV window.
static void	setSearchInstructions(MutableUINode bean, UINode searchInstructionsNode) A short instructional text which will display in the search block of the LOV window.
void	setSearchInstructions(UINode searchInstructionsNode) A short instructional text which will display in the search block of the LOV window.
static void	setSearchText(MutableUINode bean, java.lang.String searchText) Sets The string that is being searched on.
void	setSearchText(java.lang.String searchText) Sets The string that is being searched on.
static void	setTitle(MutableUINode bean, java.lang.String title) Sets Identifies the field to which this list of values applies.
void	setTitle(java.lang.String title) Sets Identifies the field to which this list of values applies.

Methods inherited from class oracle.cabo.ui.beans.MarlinBean

isEqualMarlinName

Methods inherited from class oracle.cabo.ui.beans.BaseWebBean

getDirection, getID, getID, getInlineStyle, getInlineStyle, getLanguage, getOnClick, getOnClick, getOnDoubleClick, getOnDoubleClick, getOnKeyDown, getOnKeyDown, getOnKeyPress, getOnKeyPress, getOnKeyUp, getOnKeyUp, getOnMouseDown, getOnMouseDown, getOnMouseMove, getOnMouseMove, getOnMouseOut, getOnMouseOut, getOnMouseOver, getOnMouseOver, getOnMouseUp, getOnMouseUp, getShortDesc, getShortDesc, getStyleClass, getStyleClass, isRendered, isRendered, resolveBoolean, resolveBoolean, resolveBoolean, resolveBoolean, resolveCharacter, resolveCharacter, resolveInteger, resolveInteger, resolveInteger, resolveInteger, resolveLong, resolveLong, resolveLong, resolveLong, resolveObject, resolveString, resolveString, setDirection, setID, setID, setInlineStyle, setInlineStyle, setLanguage, setOnClick, setOnClick, setOnDoubleClick, setOnDoubleClick, setOnKeyDown, setOnKeyDown, setOnKeyPress, setOnKeyPress, setOnKeyUp, setOnKeyUp, setOnMouseDown, setOnMouseDown, setOnMouseMove, setOnMouseMove, setOnMouseOut, setOnMouseOut, setOnMouseOver, setOnMouseOver, setOnMouseUp, setOnMouseUp, setRendered, setRendered, setShortDesc, setShortDesc, setStyleClass, setStyleClass

Methods inherited from class oracle.cabo.ui.BaseMutableUINode

addIndexedChild, addIndexedChild, addIndexedChild, addIndexedChildren, addIndexedChildren, clearIndexedChildren, createAttributeMap, createIndexedNodeList, createNamedChildMap, getAttributeMap, getAttributeMap, getAttributeValue, getAttributeValue, getIndexedChildCount, getIndexedNodeList, getIndexedNodeList, getNamedChildMap, getNamedChildMap, removeIndexedChild, replaceIndexedChild, setAttributeDictionary, setAttributeMap, setAttributeValue, setAttributeValue, setAttributeValue, setIndexedNodeList, setNamedChild, setNamedChildMap, setNodeID

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

ListOfValuesBean

public ListOfValuesBean()

Construct an instance of the ListOfValuesBean.

ListOfValuesBean

protected ListOfValuesBean(boolean ignored,
                           java.lang.String localName)

Construct an instance of the ListOfValuesBean. Provided for subclasses that need distinct local names..

Method Detail

getHeaderInstructions

public final UINode getHeaderInstructions()

A short instructional text which will display in the header block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

setHeaderInstructions

public final void setHeaderInstructions(UINode headerInstructionsNode)

A short instructional text which will display in the header block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

getSearchInstructions

public final UINode getSearchInstructions()

A short instructional text which will display in the search block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

setSearchInstructions

public final void setSearchInstructions(UINode searchInstructionsNode)

A short instructional text which will display in the search block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

getFilterChoice

public final UINode getFilterChoice()

This choice node should list all the table headers by which a user could search for their desired value. For instance, when searching for a department, the location and name columns might be valid filter columns, the developer may wish to display the department number, but not allow the user to filter by it. In this case this choice would contain only "Department" and "Location" items, not "Department Number". If there is only one logical filter column, this node can be omitted.

setFilterChoice

public final void setFilterChoice(UINode filterChoiceNode)

This choice node should list all the table headers by which a user could search for their desired value. For instance, when searching for a department, the location and name columns might be valid filter columns, the developer may wish to display the department number, but not allow the user to filter by it. In this case this choice would contain only "Department" and "Location" items, not "Department Number". If there is only one logical filter column, this node can be omitted.

getTitle

public final java.lang.String getTitle()

Gets Identifies the field to which this list of values applies. This attribute is merely informational for the end user. It will appear in the uppermost header in the displayed dialog (Search and Select: __title__). This field corresponds to the "Label" field in the BLAF spec.

This is a required property on the bean.

setTitle

public final void setTitle(java.lang.String title)

Sets Identifies the field to which this list of values applies. This attribute is merely informational for the end user. It will appear in the uppermost header in the displayed dialog (Search and Select: __title__). This field corresponds to the "Label" field in the BLAF spec.

This is a required property on the bean.

getSearchText

public final java.lang.String getSearchText()

Gets The string that is being searched on. It is the responsibility of the developer supplying the resultsTable to actually fill in the table based on this value. This value will be displayed in a textInput field. When the end-user clicks the 'GO' button, a "lovFilter" event will be generated, and the new searchText will be in the "searchText" parameter.

setSearchText

public final void setSearchText(java.lang.String searchText)

Sets The string that is being searched on. It is the responsibility of the developer supplying the resultsTable to actually fill in the table based on this value. This value will be displayed in a textInput field. When the end-user clicks the 'GO' button, a "lovFilter" event will be generated, and the new searchText will be in the "searchText" parameter.

getDestination

public final java.lang.String getDestination()

Gets The URL to which the form will be submitted. This will usually be null, or point back to the main page from which the LOV was called (the default).

setDestination

public final void setDestination(java.lang.String destination)

Sets The URL to which the form will be submitted. This will usually be null, or point back to the main page from which the LOV was called (the default).

getHeaderInstructions

public static UINode getHeaderInstructions(MutableUINode bean)

A short instructional text which will display in the header block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

setHeaderInstructions

public static void setHeaderInstructions(MutableUINode bean,
                                         UINode headerInstructionsNode)

A short instructional text which will display in the header block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

getSearchInstructions

public static UINode getSearchInstructions(MutableUINode bean)

A short instructional text which will display in the search block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

setSearchInstructions

public static void setSearchInstructions(MutableUINode bean,
                                         UINode searchInstructionsNode)

A short instructional text which will display in the search block of the LOV window. By the BLAF standard, this must be a styledText node with a class of "OraInstructionText."

getFilterChoice

public static UINode getFilterChoice(MutableUINode bean)

This choice node should list all the table headers by which a user could search for their desired value. For instance, when searching for a department, the location and name columns might be valid filter columns, the developer may wish to display the department number, but not allow the user to filter by it. In this case this choice would contain only "Department" and "Location" items, not "Department Number". If there is only one logical filter column, this node can be omitted.

setFilterChoice

public static void setFilterChoice(MutableUINode bean,
                                   UINode filterChoiceNode)

This choice node should list all the table headers by which a user could search for their desired value. For instance, when searching for a department, the location and name columns might be valid filter columns, the developer may wish to display the department number, but not allow the user to filter by it. In this case this choice would contain only "Department" and "Location" items, not "Department Number". If there is only one logical filter column, this node can be omitted.

getTitle

public static java.lang.String getTitle(MutableUINode bean)

Gets Identifies the field to which this list of values applies. This attribute is merely informational for the end user. It will appear in the uppermost header in the displayed dialog (Search and Select: __title__). This field corresponds to the "Label" field in the BLAF spec.

This is a required property on the bean.

setTitle

public static void setTitle(MutableUINode bean,
                            java.lang.String title)

Sets Identifies the field to which this list of values applies. This attribute is merely informational for the end user. It will appear in the uppermost header in the displayed dialog (Search and Select: __title__). This field corresponds to the "Label" field in the BLAF spec.

This is a required property on the bean.

getSearchText

public static java.lang.String getSearchText(MutableUINode bean)

Gets The string that is being searched on. It is the responsibility of the developer supplying the resultsTable to actually fill in the table based on this value. This value will be displayed in a textInput field. When the end-user clicks the 'GO' button, a "lovFilter" event will be generated, and the new searchText will be in the "searchText" parameter.

setSearchText

public static void setSearchText(MutableUINode bean,
                                 java.lang.String searchText)

Sets The string that is being searched on. It is the responsibility of the developer supplying the resultsTable to actually fill in the table based on this value. This value will be displayed in a textInput field. When the end-user clicks the 'GO' button, a "lovFilter" event will be generated, and the new searchText will be in the "searchText" parameter.

getDestination

public static java.lang.String getDestination(MutableUINode bean)

Gets The URL to which the form will be submitted. This will usually be null, or point back to the main page from which the LOV was called (the default).

setDestination

public static void setDestination(MutableUINode bean,
                                  java.lang.String destination)

Sets The URL to which the form will be submitted. This will usually be null, or point back to the main page from which the LOV was called (the default).