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

When-New-Form-Instance Trigger

Description

At form start-up, Oracle Forms navigates to the first navigable item in the first navigable block. A When-New-Form-Instance trigger fires after the successful completion of any navigational triggers that fire during the initial navigation sequence.

This trigger does not fire when control returns to a calling form from a called form.

In a multiple-form application, this trigger does not fire when focus changes from one form to another.

Definition Level form

Legal Commands

SELECT statements, restricted Built-ins, unrestricted Built-ins

Enter Query Mode no

On Failure

no effect

Fires In

Run the Form

When-New-Form-Instance Trigger Restrictions

When-New-Form-Instance Trigger Example

This example calls routine to display dynamic images, starts a timer to refresh the on-screen clock, and queries the first block.

BEGIN
Populate_Dynamic_Boilerplate;
Start_OnScreen_Clock_Timer;
Go_Block('Primary_Ord_Info');

/*
** Query the block without showing
** the working message.
*/
:System.Suppress_Working := 'TRUE';
Execute_Query;
:System.Suppress_Working := 'FALSE';
END;