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

Name
BEEP Service
CHOOSECOLOR Service
CHOOSEDIR Service
CHOOSEFILE Service
CHOOSEFONT Service
COPYFILE Service
CREATE Service
CURSOR Service
DESTROY Service
FLUSH Service
GET_EVENT Service
GETLOGICALDRIVES Service
MAKEDIR Service
OBJECTID Service
OBJECTLIST Service
PRINTSETUP Service
REMOVEDIR Service
RENAMEDIR Service
RENAMEFILE Service
RUNHELP Service
TEXTRECT Service
WINCOUNT Service
HANDLE_BY_CURSOR Service
IUNKNOWN_RELEASE Service
LOAD_PICTURE Service
OBJECT_BY_CURSOR Service
PICTURE_PROPS Service


Example

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