A script-enabled browser is required for this page to function properly.

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 navigation is the result of a NEXT_ITEM (Tab key), item A and all items between A and B (in terms of their sequence number within the block, not in terms of their position in the block's navigation sequence) are validated. This can cause redundant validation. For example, if you use the Next Navigable Item property to establish a navigation sequence that is the reverse of the items' sequence within the block (as shown in the Object Navigator), then every time you hit tab, all items in the block (except the one you are tabbing to) will be validated. (In Form Builder 5.0, only item A is validated.)

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, Oracle Forms 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

/*

** Built-in: NEXT_ITEM
** Example: See NEXT_BLOCK
*/