SetConfirm() As Long

Description

This event is fired right before the usual Confirm dialog appears when a Set is complete. It is only fired in Verify, during verification in full screen mode. Note that Set finished must be selected in the Confirmations dialog (FORMS Help topic) in the Verify job description in order for this event to occur.

To skip the usual Confirm dialog, return EV_OK_ABORT and use the Application.SetReturnValue(0, "N") method to pause Verify. Otherwise, use Application.SetReturnValue (0, "Y") to continue to the next Set. If you forget to use SetReturnValue, FORMS continues to the next Set. Note that the Set status is not recalculated after this event. If you change status of any form in the set, you must update the Set status yourself.

Parameters

None.

Return values

Return value

Description

EV_OK

Normal return.

EV_OK_ABORT 

Skips the normal dialog.

EV_ERROR

Causes an error message and job termination.

Suggested usage

Could be used to display your own confirmation dialog instead of FORMS’ usual one. This is the very last event on a Set in Verify before the next Set to verify is shown.

Remarks

Only fired in the Verify module. If Set finished is not selected in the Confirmations dialog in the Verify job description, this event is not fired at all.

Set-level events