FeatureIsItemSelected

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

FeatureIsItemSelected 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

FeatureIsItemSelected 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