"ShellExecute" Action

 

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 See Also
List of Available Actions
"Run" Action