Oracle Forms Developer – Form Builder Reference, Volume 1

NEXT_ITEM built-in
Description
Navigates to the navigable item with the next higher sequence number than the current item. If there is
no such item, NEXT_ITEM navigates to the item with the lowest sequence number. If there is no such
item, NEXT_ITEM navigates to the current item.
If the validation unit is the item, NEXT_ITEM validates any fields with sequence numbers greater than
the current item or less than the target item.
The function of NEXT_ITEM from the last navigable item in the block depends on the setting of the
Navigation Style block property. The valid settings for Navigation Style include:
Same Record (Default): A Next Item operation from a block’s last item moves the input focus to the first
navigable item in the block, in that same record.
Change Record: A Next Item operation from a block’s last item moves the input focus to the first
navigable item in the block, in the next record. If the current record is the last record in the block and
there is no open query, Form Builder creates a new record. If there is an open query in the block (the
block contains queried records), Oracle forms retrieves additional records as needed.
Change Block: A Next Item operation from a block’s last item moves the input focus to the first
navigable item in the first record of the next block.
Syntax
PROCEDURE NEXT_ITEM;
Built-in Type restricted procedure
Enter Query Mode yes
Parameters
none
NEXT_ITEM examples
300
/*
** Built-in: NEXT_ITEM
** Example: See NEXT_BLOCK
*/