Description

Passes <Object> as a command line string to the Windows CreateProcess function, to run a program.

Note: If <Object> is a program, the fully qualified path name of the file needs to be passed. Thus, passing WINWORD.EXE to run Microsoft Word will not work.

Parameters

ParameterDescription
<value>(Optional.) An @FM-delimited array:
 
Value
<1> Mode to be passed to Windows CreateProcess function. If Value<1> is a negative number, then RUNWIN will work as a "modal" call (it will block all OpenInsight forms and will not return control to the caller until the calling application is completed). returnvalue is then an application exit code.

Valid modes are:

ValueMode
-1Modal
0Hidden
1Normal
2ShowMinimized
3Maximized
4Show but do not activate
5Show
6Minimize
7Show minimized but do not activate
8Show Not Available
9Restore
<2> Name of callback function to be called when an activated now application is terminated.
<3> Parameter to be passed to the callback function
returnvalue

An @FM-delimited array:

Value
<1> Full path to the calling application
<2> Instance handle
<3> Module handle
<4> Task handle

Remarks

For more information about RUNWIN, refer to EXITCODE in Chapter 4: Properties.

See Also


Example

declare function utility
program = "C:\Program Files\Microsoft | Office\Office10\WINWORD.EXE"
mode = 6  ;* minimized
rv = Utility("RUNWIN", program, mode)
  • No labels