Core Function Run
From Sputnik Wiki
(Difference between revisions)
| Line 1: | Line 1: | ||
<pre> | <pre> | ||
| − | Run( <file>, <arguments>, <workdir>, <flag> ) | + | Run( <file>, <arguments>, <workdir>, <flag>, <show options> ) |
</pre> | </pre> | ||
| Line 29: | Line 29: | ||
@SW_MAXIMIZE = Maximized window | @SW_MAXIMIZE = Maximized window | ||
</pre> | </pre> | ||
| + | |||
| + | Default runs the program normally. | ||
| + | |||
| + | ==== show options ==== | ||
| + | |||
| + | Optional; Options how to executed program will run: | ||
| + | <pre> | ||
| + | 0 = Run within the current process so that anything printed to console by the run program appears directly on ours. | ||
| + | 1 = Run the program within its own window and dont share our console. | ||
| + | </pre> | ||
| + | |||
| + | Default 0. | ||
=== Return Value === | === Return Value === | ||
Revision as of 17:33, 1 December 2011
Run( <file>, <arguments>, <workdir>, <flag>, <show options> )
Contents |
Description
Runs an external program.
Parameters
file
The name of the executable (EXE, BAT, COM, or PIF) to run.
arguments
Optional; The arguments to use.
workdir
Optional; The working directory.
flag
Optional; The "show" flag of the executed program:
@SW_HIDE = Hidden window @SW_MINIMIZE = Minimized window @SW_MAXIMIZE = Maximized window
Default runs the program normally.
show options
Optional; Options how to executed program will run:
0 = Run within the current process so that anything printed to console by the run program appears directly on ours. 1 = Run the program within its own window and dont share our console.
Default 0.
Return Value
Success: The PID of the process that was launched.
Failure: 0.
Remarks
After running the requested program the script continues. To pause execution of the script until the spawned program has finished use the RunWait function instead.
Example
Run("Notepad.exe", "", @SW_MAXIMIZE);
