DisplayRunTimeErrorDialogEx Method
Syntax
Engine.DisplayRunTimeErrorDialogEx ( dlgTitle, sequenceContextParam, dlgOptions, suspendExecution, dontShowAgainForExecution, dontShowAgainForBatch, runTimeErrorAction)
Purpose
Launches the Run-Time Error dialog box.
Remarks
The sequence editor and user interfaces typically call this function in response to a UIMsg_BreakOnRunTimeError event. The dialog box allows the user to specify how the execution is to proceed.
Parameters
dlgTitle As String
[In] Specifies the title of the dialog box. Pass an empty string to use the default title for the dialog box.
sequenceContextParam As SequenceContext
[In] Pass the sequence context from the thread that caused the run-time error.
dlgOptions As long
[In] Pass either CommonDlgOption_NoOptions or CommonDlgOption_ModalToAppMainWnd.
suspendExecution As Boolean
[Out] Returns whether the user wants the current execution to suspend at the location of the run-time error.
dontShowAgainForExecution As Boolean
[Out] Returns whether the user wants this dialog box to appear again if another run-time error occurs in the current execution. If this value is True, set Execution.RTEOptionForThisExecution to specify what to do on a run-time error for this execution.
dontShowAgainForBatch As Boolean
[Out] Returns whether the user wants this dialog box to appear again if another run-time error occurs in any execution that has a thread from the same batch as the thread in the sequence context that you specify. If this value is True, call Thread.SetBatchRTEOption to set what to do on a run-time error for these executions.
runTimeErrorAction As RTEOptions
[Out] Returns the option the user selects in the dialog box to specify how the execution is to proceed.