Oracle Forms Developer – Form Builder Reference, Volume 1

LIST_VALUES built-in
Description
LIST_VALUES displays the list of values for the current item, as long as the input focus is in a text item
that has an attached LOV. The list of values remains displayed until the operator dismisses the LOV or
selects a value.
By default, LIST_VALUES uses the NO_RESTRICT parameter. This parameter causes Form Builder
not to use the automatic search and complete feature. If you use the RESTRICT parameter, Form
Builder uses the automatic search and complete feature.
Automatic Search and Complete Feature With the automatic search and complete feature, an LOV
evaluates a text item’s current value as a search value. That is, if an operator presses [List] in a text item
that has an LOV, Form Builder checks to see if the item contains a value.
If the text item contains a value, Form Builder automatically uses that value as if the operator had entered
the value into the LOV’s search field and pressed [List] to narrow the list.
If the item value would narrow the list to only one value, Form Builder does not display the LOV, but
automatically reads the correct value into the field.
Syntax
PROCEDURE LIST_VALUES
(kwd NUMBER);
Built-in Type restricted procedure
Enter Query Mode no
Parameters
kwd Specifies one of the following constants:
270
NO_RESTRICT Specifies that Form Builder will not use the automatic
search and complete feature.
RESTRICT Specifies that Form Builder will use the automatic search and
complete feature.