Run or open file, folder, www page, create e-mail message

Syntax

run file [par] [verb] [dir] [flags] [window] [hwnd]

Parameters

Remarks

file can be program, document, shortcut, folder or Internet resource ("http://...", "mailto:...", etc). To open web pages, you can also use web.

When using as function, run returns handle of the started process (running program) or -1. Later it must be closed with CloseHandle, unless assigned to a __Handle variable. Example: __Handle h=run("notepad"); wait 0 H h; out "closed".

When using as function with flag 0x400 (wait for exit), run returns program's exit code.

The speed depends on spe.

To run/open objects that cannot be specified by path (e.g., Control Panel objects), can be used ITEMIDLIST string.

Class id strings in format "::{XXXX}\{XXXX}" also are supported. Starting from QM 2.2.0, some other functions also can use it, e.g. can get icon, create shortcut.

On Vista/7, if UAC is on, most programs don't have administrator privileges even on administrator account. If a program has administrator privileges, programs launched from it also have the same privileges. run behaves differently, except in exe. Even if QM is running as administrator, programs launched by run don't have administrator privileges. To run as administrator, use flags 0x10000-0x30000. Function web also launches IE as not administrator. Functions StartProcess, RunAs and some Windows API functions also can launch programs with different privileges. Other functions (RunConsole2, CreateProcess, etc) launch programs with the same privileges as of QM, but without uiAccess.

Tips

You can drag and drop a file onto the macro text to insert run command for that file. Ctrl can be used to insert shortcut path instead of target path. You also can drag Internet links, virtual folders/objects, multiple files. You can also drop onto a toolbar.

If file is document, opens it in default program for that file type. To open in certain program, use program in file and document in par. Example: run "wordpad.exe" "c:\x.txt".

If macro intends to do something with new window, but program loads slowly, try flag 0x200, or/and window together with flag 0x800. Or, after run include wait or wait for command ("wait", "wait for active window", etc).

Sometimes, program started by run shows a dialog. Macro should close the dialog, but run waits until you manually close the dialog. In such case, create a function that closes the dialog, and start it from the macro using mac. See example.

To run a console program and capture its output, use RunConsole2 instead.

To run a program as another user, use RunAs instead. It does not require user interaction if you specify encrypted password. It cannot be used on Vista/7 to run as current user with elevated privileges (instead use run with flags 0x10000-0x30000 or verb "runas", or StartProcess).

Examples

run "c:\f\text.txt" ;;open text.txt
run "notepad" ;;run Notepad
run "c:\f\my file.lnk" ;;run shortcut
run "c:\m" "" "explore" ;;explore folder
run "c:\t.txt" "" "print" ;;print "t.txt"
run "control" "appwiz.cpl" ;;open Control Panel "Add/Remove Programs"
run "notepad" "" "" "" 3 ;;run Notepad, maximized

 Run or activate Notepad:
run "notepad" "" "" "" 0 "Notepad"

 Run Notepad with parameters "s.cpp", default directory "c:\f":
run "notepad" "s.cpp" "" "c:\f"

 Run program and wait max. 15 s until CPU usage is < 10%:
run "app.exe"; wait 15 P 10

run "http://www.aaa.com" ;;open web page
run "mailto:name@isp.com" ;;create new e-mail message
run "mailto:name@isp.com?subject=Question" ;;create new e-mail message

 Run program with command line with variables:
str x.expandpath("$documents$\test.txt")
int y=5
str cl=F"/X ''{x}'' /Y {y}"
run "zzz.exe" cl

 Run Notepad and wait untill its process ends:
run "notepad.exe" "" "" "" 0x400

 Run program that shows a dialog at startup, which causes run to wait:
mac "CloseDialog"
run "program"
...
 _________________________________________
 Function CloseDialog:
wait(10 "Dialog Name"); err ret
key Y