Command: SUDDlgCreate

Display all  Hide all

Command: SUDDlgCreate

Generates a non-modal SUD dialog box.

Input Parameters

SUDDlgName	Specifies the name of a user dialog box to be displayed. String variable
SUDFileName	Specifies the name of a SUD file. By default the SUDFileName variable contains an empty text. String variable

Return Parameters

If you specify the user dialog box without a filename extension, DIAdem first searches for the file with the filename extension .sud and then for the encrypted file with the filename extension .suc.

Note  Use the methods Dialog.Show and Dialog.Hide to display and to hide a non-modal user dialog box. Use the methods Dialog.OK and Dialog.Cancel to close the non-modal dialog box. Refer to Modal and Non-Modal User Dialog Boxes for further information on working with non-modal dialog boxes.

Note  The SudDlgCreate command can open a specified user dialog box only once in non-modal mode. Use the SudNonModalDlgLst command to receive a list of non-modal user dialog boxes that are already open. If you want to open several dialog boxes at the same time, use the SUDDlgCreateEx command.

Note  Use the Dialog.Filename variable instead of the AutoActPath variable in a non-modal user dialog box.

Note  If data is changed, DIAdem always refreshes the Data Portal in user dialog boxes when the script runs. If you disable refreshing, you speed up the script. To do this, use the UIAutoRefreshSet command. Use the UIAutoRefreshSet command at the end of the script to restore the refresh state to its original value. If you disabled the refresh mode in a non-modal dialog box with the UIAutoRefreshSet command, you must enable the refresh mode with the UIAutoRefreshSet command when the EventTerminate event occurs at the latest. If you used the ScriptStart command to call a script from the non-modal dialog box, DIAdem refreshes the data changes automatically when the script is finished.

Example

The following example executes the non-modal display of the user dialog box Dialog1 from the Example.SUD file.

Dim MyDlg
If Nothing is SudNonModalDlgLst("Dialog1") Then
  Set MyDlg = SudDlgCreate("Dialog1","Example")
Else
  Set MyDlg = SudNonModalDlgLst("Dialog1")
End If

Call MyDlg.Show

if None is dd.SudNonModalDlgLst("Dialog1"): 
    MyDlg = dd.SudDlgCreate("Dialog1","Example") 
else: 
    MyDlg = dd.SudNonModalDlgLst("Dialog1") 
MyDlg.Show 

Related Topics

Command: ProcessMessages | Command: SUDDlgCreateEx | Command: SUDNonModalDlgLst | Method: IsValid for Dialog <NonModal> | Modal and Non-Modal User Dialog Boxes | Variable: SUDNonModalDlgCount | Variable: SUDNonModalDlgId