Description
This action can launch a document with its associated program (or a program), much like the run
action. You can e.g. use it to run batch files or print text documents.
Parameters
The following is a list of the supported parameters:
- FileNameREQVAR
-
Value
String
Description
Specifies the name of the file/document to be launched. If you want to run a program, you can use the run
action instead.
Example
FileName: "%MyAppPath%\License.doc"
- ParametersVAR
-
Value
String
Description
If you want to pass command-line parameters to the program that is used to launch the file, you can put them here.
Example
Parameters: "/someparameter"
- WorkingDirVAR
-
Value
String
Description
With this parameter, you can control the directory in which the program is executed that's used to launch the file. Some programs look for files in the 'current' directory, so in that case this setting will be useful.
Example
WorkingDir: "%MyAppPath%"
- ShowCmd
-
Value
normal
|hidden
|maximized
|minimized
Description
Most programs open a window on the screen when executed; with this setting, you can control how (and if) that window will be shown.
Example
ShowCmd: normal
- Verb
-
Value
String
Description
The verb controls the action that is performed. If no verb is specified, the default one will be used by Windows. You can find out which verbs are supported for a file type in the Windows registry (look up information on Windows' file type associations if you don't know what I'm talking about).
Example
Verb: "Print"
- Flags
-
Value
Flag list
Description
This parameter is a set of extra options. Multiple options may be used by separating them by spaces. The following options are supported:
- ignoreerrors
- Normally, AeTrayMenu pops up a message box when the action cannot be performed for some reason (e.g. when it can't find the program). Specify this flag to suppress these error messages.
- waituntilterminated
- If you're executing multiple actions sequentially (in a batch action section), you can use this flag to suspend execution of the next action until the program has been terminated.
- waituntilidle
- This flag works like the
waituntilterminated
flag, but instead waits until the program is waiting for user input with no input pending.
Example
Flags: ignoreerrors waituntilterminated
Examples
Action: shellexecute; FileName: "%MyAppPath%\License.doc"; Verb: "Print"
Action: shellexecute; FileName: "%AeTrayMenuPath%\AeTrayMenu.ini"; WorkingDir: "%Windows%"; Flags: waituntilidle

See Also
List of Available Actions
"Run" Action