Summary

Synopsis

This article discuss how to launch a ReadMe file from the SetupCompleteSuccess dialog.

Discussion

To launch a ReadMe file, follow these steps:

1. Navigate to the Dialogs view and open the Dialog Layout for the SetupCompleteSuccess dialog.

2. Set the TabStop of the Bitmap dialog control to True.

3. Give the ReadMe check box control a value in the Value property if there is no value.

4. Navigate to the Property Manager view.

5. Add the property called SHOWLAUNCHREADME with a value of -1.

6. Add the property called READMEFILETOLAUNCHATEND with a value of 1.

7. Open the Custom Actions view.

8. Add a Launch EXE custom action that launches a text viewer application and passes the ReadMe file to it.

9. Navigate to the Dialogs view and select the SetupCompleteSuccess dialog.

10. Insert this custom action as a new DoAction event on the Behavior of the SetupCompleteSuccess dialog for the OK button.

11. As a condition on the new Doaction add the LAUNCHREADME property and set it equal to the value specified for the check box in step 3.

12. (Optional) If you want the ReadMe check box selected by default, add the LAUNCHREADME property in the Property Manager. If you do not create this property, the dialog will display the check box, but will not have it selected by default.

Related KB Articles

Additional Information

An InstallScript custom action may not successfully launch from the OK button control on the SetupCompleteSuccess dialog. This is because the custom action ISCleanupSuccess is executed before the custom action to view the ReadMe is launched. ISCleanupSuccess removes the InstallScript engine from memory, and the InstallScript custom action will not launch successfully.

For more information, see Knowledge Base article "Dialog Control Is Covered by the Background Bitmap".

Additional information regarding launching executables can be found in Knowledge Base article "Launch a Custom Executable".

The InstallScript action ISCleanupSuccess is discussed in the HelpNet article Runtime Behavior for Basic MSI Installations with InstallScript Custom Actions