This event is fired right before the usual dialog appears when a form is complete. It is only fired in Verify, and only during verification in full screen mode. Note that must be selected in the dialog (FORMS Help topic) in the Verify job description in order for this event to occur.
To skip the usual dialog, return EV_OK_ABORT and use the SetReturnValue(0, "N") method to pause Verify. Otherwise, use SetReturnValue (0, "Y") to continue to the next form. If you forget to use SetReturnValue, FORMS proceeds with the next form. If you call any method from this event, form status is recalculated after the event.
|
SetReturnValue |
Description |
|
Y |
Continue with the next form. Default action. |
|
N |
Pause job, i.e. stay focused on the current form |
If Unidentified forms are included in the job description and the current form was originally created in Verify using the command (FORMS Help topic), there are two extra return values to use. In this case the confirmation message reads "Finished. Do you want to create another one?"
|
SetReturnValue |
Description |
|
Y |
Create a new form. Default action. |
|
N |
Pause job, i.e. stay focused on the current form. |
|
C |
Continue verifying forms from database. |
|
CopyForm |
Create an identical copy of the current form and trigger the FormCopied event, where you can adjust the new form for the user. The new form has its own copies of archive images, appendices and field images. Intended for advanced API programmers. |
None.
|
Return value |
Description |
|
EV_OK |
Normal return. |
|
EV_OK_ABORT |
Skips the normal dialog. |
|
EV_ERROR |
Causes an error message and job termination. |
Could be used to display your own confirmation dialog instead of FORMS' usual one. This is the very last event on a form in Verify before the next form to verify is shown.
Only fired in the Verify module, and only if is selected in the dialog in the Verify job description.