Modeller.startDialog


startDialog(fileName, [runModal], [commandStrings], [wait])

Executes the dialog found at the pathname given The first optional argument passed is used to control whether or not the new dialog runs in modal (blocking) mode. If the file given is an executable, this function passes the given array of named values direct to the dialog as it starts up, in the form of a command line. It will also pass through the HWND of Modeller in the form "hwnd=1234", such that the dialog can be created as a child of Modeller. It will also pass through the modal flag in the form "modal=TRUE" or "modal=FALSE" to the new process. The new process is responsible for handling this flag by calling "modeller.enableUI(true/false)" during its startup. If the file given is a tfm file, modeller creates a window in which the tfm file is created, and modeller is responsible for handling the runModal flag. The array of command strings is ignored.

fileNamestringFull pathname of the executable (or script or scriptable dialog) to run
runModaloptional boolean TRUE to run in modal or 'blocking' mode
commandStringsoptional array of strings These strings will be passed direct to the new process. Each string is of the form "name=value"
waitoptional boolean TRUE to wait until the dialog is closed
Return valuenone 

Back to Modeller

Back to Overview