Oracle Forms Developer – Form Builder Reference, Volume 1

GET_LIST_ELEMENT_LABEL built-in
Description
Returns information about the requested list element label.
Syntax
FUNCTION GET_LIST_ELEMENT_LABEL
(list_id ITEM,
list_name VARCHAR2,
list_index NUMBER);
FUNCTION GET_LIST_ELEMENT_LABEL
(list_name VARCHAR2,
list_index NUMBER);
Built-in Type unrestricted function
Returns VARCHAR2
Enter Query Mode yes
Parameters
list_id Specifies the unique ID that Form Builder assigns when it creates the list
item. Use the FIND_ITEM built-in to return the ID to an appropriately
typed variable. The data type of the ID is ITEM.
list_name The name you gave to the list item when you created it. The data type of
the name is VARCHAR2.
list_index Specifies the list index value. The list index is 1 based. If the index is
greater than the count of elements in the list,
GET_LIST_ELEMENT_LABEL will fail.
Usage Notes
The value associated with a list item element is not necessarily the list item’s current value. That is, the
value of :block.list_item.
GET_LIST_ELEMENT_LABEL examples
200
/*
** Built-in: GET_LIST_ELEMENT_LABEL
** Example: See GET_LIST_ELEMENT_COUNT
*/