Navigational triggers fire in response to navigational events. For instance, when the operator clicks on a text item in another block, navigational events occur as Oracle Forms moves the input focus from the current item to the target item.
Navigational events occur at different levels of the Oracle Forms object hierarchy (Form, Block, Record, Item). Navigational triggers can be further sub-divided into two categories: Pre- and Post- triggers, and When-New-Instance triggers.
Pre- and Post- Triggers fire as Oracle Forms navigates internally through different levels of the object hierarchy. As you might expect, these triggers fire in response to navigation initiated by an operator, such as pressing the [Next Item] key. However, be aware that these triggers also fire in response to internal navigation that Oracle Forms performs during default processing. To avoid unexpected results, you must consider such internal navigation when you use these triggers.
Trigger |
Typical Usage |
---|---|
Perform an action just before Oracle Forms navigates to the form from "outside" the form, such as at form startup. |
|
Perform an action before Oracle Forms navigates to the block level from the form level. |
|
Perform an action before Oracle Forms navigates to the record level from the block level. |
|
Perform an action before Oracle Forms navigates to a text item from the record level. |
|
Manipulate an item when Oracle Forms leaves a text item and navigates to the record level. |
|
Manipulate a record when Oracle Forms leaves a record and navigates to the block level. |
|
Manipulate the current record when Oracle Forms leaves a block and navigates to the form level. |
|
Perform an action before Oracle Forms navigates to "outside" the form, such as when exiting the form. |
When-New-Instance-Triggers fire at the end of a navigational sequence that places the input focus on a different item. Specifically, these triggers fire just after Oracle Forms moves the input focus to a different item, when the form returns to a quiet state to wait for operator input.
Unlike the Pre- and Post- navigational triggers, the When-New-Instance triggers do not fire in response to internal navigational events that occur during default form processing.
Trigger |
Typical Usage |
---|---|
Perform an action at form start-up. (Occurs after the Pre-Form trigger fires). |
|
Perform an action immediately after the input focus moves to an item in a block other than the block that previously had input focus. |
|
Perform an action immediately after the input focus moves to an item in a different record. If the new record is in a different block, fires after the When-New-Block-Instance trigger, but before the When-New-Item-Instance trigger. |
|
Perform an action immediately after the input focus moves to a different item. If the new item is in a different block, fires after the When-New-Block-Instance trigger. |