InstallShield 2016 » InstallScript Language Reference
Feature event handlers carry out processes required just before and just after the installation or uninstallation of a single feature. The number of feature events and handlers depends on the number of features in your project.
To create an event handler function for a feature, select the feature name from the left event-category list, and select the event you want from the right event list. InstallShield creates a second InstallScript file, called FeatureEvents.rul, in the InstallScript view.
Note that if you change the default feature event handler code in FeatureEvents.rul, you must put the following statement in Setup.rul to include your changes in the installation:
#include "FeatureEvents.rul"
Following is a list of the feature event handlers.
Event Handler |
Project Type |
Description |
InstallScript InstallScript MSI |
In InstallScript projects: Runs in response to the Installed event that is generated just after the applicable feature is installed on the target system. In InstallScript MSI projects: Runs just after Windows Installer transfers the files to the target system. |
|
InstallScript InstallScript MSI |
In InstallScript projects: Runs in response to the Installing event that is generated just before the feature is installed on the target system. In InstallScript MSI projects: Runs just before Windows Installer transfers the files to the target system. |
|
InstallScript InstallScript MSI |
In InstallScript projects: Runs in response to the UnInstalled event that is generated just after the feature is removed from the target system. In InstallScript MSI projects: Runs just after Windows Installer removes the files from the target system. |
|
InstallScript InstallScript MSI |
In InstallScript projects: Runs in response to the UnInstalling event that is generated just before the feature is removed from the target system. In InstallScript MSI projects: Runs just before Windows Installer removes the files from the target system. |
Project • Because Windows Installer controls the installation of features in InstallScript MSI installations, the order in which feature event-handler functions are called cannot be specified. In addition, feature events are not launched until all features are copied to the target system.
Also note that feature-uninstallation event handlers (OnUnInstalling and OnUnInstalled) are not called during rollback.
See Also
InstallShield 2016 Help LibraryMay 2017 |
Copyright Information | Flexera Software |