Oracle Forms Developer – Form Builder Reference, Volume 1

When-New-Item-Instance trigger
Description
Fires when the input focus moves to an item. Specifically, it fires after navigation to an item, when Form
Builder is ready to accept input in an item that is different than the item that previously had input focus.
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins.
Enter Query Mode yes
Usage Notes
Use a When-New-Item-Instance trigger to perform an action whenever an item gets input focus. The
When-New-Item-Instance trigger is especially useful for calling restricted (navigational) built-ins.
On Failure
no effect
Fires In
Return for Input
See Process Flowcharts
When-New-Item-Instance trigger restrictions
The conditions for firing this trigger are not met under the following circumstances:
• Form Builder navigates through an item, without stopping to accept input
• the input focus moves to a field in an alert window, or to any part of an Form Builder menu
521