InstallShield 2019 » InstallScript Language Reference
Project • This information applies to the following project types:
• | InstallScript |
• | InstallScript MSI |
Project-specific differences are noted where appropriate.
In InstallScript projects, FeatureIsItemSelected determines the current selection state of the specified feature. In InstallScript MSI projects, FeatureIsItemSelected determines the current installed state of the specified feature. You can also use FeatureGetData to determine if a feature is selected.
FeatureIsItemSelected is typically called to perform feature-specific tasks before or after file transfer. To perform feature-specific tasks during file transfer in an InstallScript installation, it is recommended that you place code in feature event handler functions.
Syntax
FeatureIsItemSelected ( szFeatureSource, szFeature );
Parameters
Parameter |
Description |
szFeatureSource |
In InstallScript projects, specifies the media library for which the installed state or selection setting is determined. In InstallScript MSI projects, specifies the media name of the script-created feature set. |
szFeature |
Specifies the name of the feature for which the installed state or selection setting is determined. To learn how to refer to top-level features and subfeatures, see Specifying Features and Subfeatures in Function Calls. |
Return Values
Return Value |
Description |
TRUE (1) |
In InstallScript projects, szFeature is selected. In InstallScript MSI projects, szFeature’s installed state is INSTALLSTATE_LOCAL (feature was installed on the local drive). |
FALSE (0) |
In InstallScript projects, szFeature is deselected. In InstallScript MSI projects, szFeature's installed state is INSTALLSTATE_ABSENT (feature was uninstalled). |
< 0 |
The function failed to determine if the feature was installed or selected. Call FeatureError for additional information. |
See Also
InstallShield 2019 Help LibraryApril 2019 |
Copyright Information | Flexera |