RunProgram Method

Top  Previous  Next

Lokas Software AWinstall Online Help
Start Page
Engine Functionality
Tasks and Actions
Installer Variables
Reading from Registry and Environment
Tips And Tricks
Frequently Asked Questions
Installer Actions
Extract Files with Folders
Register COM DLL
Register COM Type Library
Create Shortcuts and Start Menu Items
Register Fonts
Add Registry Keys
Add Keys from .reg file
Add Keys from System Registry
Run External Programs
Add Uninstall Shortcut
Setup Builder Interface
Main Windows
Property Pane
Project Tree
Event Log
Menu bar commands
File
Edit
View
Project
Task
Help
Toolbars
Standard
Actions
Extending your setups
Script Actions
Installer Object
AddRegKey Method
CancelInstall Method
CopyFile Method
CreateObject Method
CreateShortcut Method
RegisterFont Method
RegisterServer Method
RegisterTypeLib Method
RunProgram Method
ShowMessage Method
Variables Method
VersionMajor Property
VersionMinor Property
General Information
Product Registration
History of Changes
  download AWinstall

Launches an external program or opens an external document.

[VBScript]

Installer.RunProgram Path, Params, bWait

 

[JScript]

Installer.RunProgram(Path, Params, bWait);

Parameters

Path

Path to document or executable file.

Params

Executable file parameters (if Path is a document file, Params should be empty).

bWait

Boolean value indicating whether the installer should wait for the program to finish executing before continuing to the next installer action.

Remarks

This method allows you to launch an external executable with string parameters. It also supports the opening of document files registered on a target system. Also, hyperlink protocol is supported, so you may use it to visit a specific Web page. Refer to the documentation of a ShellExecuteEx function for more details.

Installer variables are supported in the following parameters: Path and Params. To emit the value of installer variable MyVar, use the following form: ${MyVar}.

Uninstall support

This action does not support uninstallation.

Example (VBScript)

res = Installer.ShowMessage("Do you wish to visit the ${ProductName} web site?", _

  "Finishing installation", vbYesNo+vbExclamation)

If res = vbYes Then

  Installer.RunProgram "http://www.awinstall.com/moreinfo.html"""False

End If

Example (JScript)

res = Installer.ShowMessage("Do you wish to visit the ${ProductName} web site?",

  "Finishing installation", 4 + 48);

if (res == 6)

  Installer.RunProgram("http://www.awinstall.com/moreinfo.html"""false);

© 2007 Lokas Software