This event is fired from Interpret, Verify, and Transfer when there are no more forms available for the module to handle and the "No more forms" message is about to be shown. Interpret fires this event after the JobStopped event; Verify and Transfer fire it before the JobStopped event.
None.
|
Return value |
Description |
|
EV_OK |
Show the "No more forms" message. |
|
EV_OK_ABORT |
Do not show the "No more forms" message. |
|
EV_ERROR |
End job and show error message. |
Could be used to suppress the "No more forms" dialog, if a new job description has just been loaded (Interpret) or is about to be loaded (Verify, Transfer) by setting the property NextJob on the JobStopped event. Or use this event in Interpret to suppress the "No more forms" dialog and load and start another job (calling LoadJob and StartJob).
Note that when Verify and Transfer proceed to the JobStopped event, the forms database is closed. In Verify this means that the user can no longer return to and edit previous forms. However you can prevent the database from closing by calling the SetReturnValue method in this event and setting the VBA return value to "P". Verify is paused and the job is not stopped.
This means that you can have the user confirm via a dialog that it is ok to stop the job. If the verifier does not want to stop the job (because previous forms still need to be modified), set the return value to "P" and return EV_OK_ABORT. The user can then back up to previous forms and make the necessary changes.
If Unidentified forms are included in the job description, then the message reads "Session complete. No more forms with current status and type available. Do you want to add a new form?". In this case, you have a third option, which is to create a new blank form (FORMS Help topic). If you want to create a new form, set the return value to "Y" and return EV_OK_ABORT.
This event is fired in the Interpret, Verify, and Transfer modules.