Feature Object

InstallShield 2016 » Object Expressions for Advanced UI and Suite/Advanced UI Projects

To create an object expression that checks target systems for information about a feature in an Advanced UI or Suite/Advanced UI installation, use the Feature object. The Feature object has support for properties such as DisplayName, ActionState, and InstalledState.

Syntax

[@Feature(FeatureName).ActionState]

[@Feature(FeatureName).AllowSelectionChange]

[@Feature(FeatureName).Cost]

[@Feature(FeatureName).Description]

[@Feature(FeatureName).DisplayName]

[@Feature(FeatureName).InstalledState]

[@Feature(FeatureName).Visible]

Parameters

One parameter is available for the Feature object.

Parameters for the Feature Object
Parameter	Description
FeatureName	Specify the name of the feature.

Properties

The following properties are available for the Feature object.

Properties for the Feature Object

Property

Description

ActionState

Retrieves the currently set action state of the feature. Valid values are:

•

0—No action will be taken for the feature.

•

1—The feature will be installed.

•

2—The feature will be removed.

AllowSelectionChange

Retrieves a Boolean value that indicates whether end users should be allowed to select or deselect the feature on the InstallationFeatures wizard page. Valid values are:

•

true—End users should be able to select or deselect the feature through the wizard interface. This is the default option.

•

false—End users should not be able to select or deselect the feature through the wizard interface. If this feature is visible on the InstallationFeatures wizard page, it appears in a read-only state (either selected or deselected, based on other factors, such as the feature’s condition).

Cost

Retrieves how much space (in bytes) the feature requires on the target system if this value was specified in the Features view.

Description

Retrieves the localized description of the feature.

DisplayName

Retrieves the localized display name of the feature.

InstalledState

Retrieves the installed state of the feature as determined by the package detection states of the packages in the feature. Valid values are:

•

0—The feature is not currently installed.

•

3—The feature is installed.

Visible

Retrieves a Boolean value that indicates whether the feature should be visible on the InstallationFeatures wizard page during installation.

Examples

The following examples demonstrate use of the Feature object in object expressions.

Sample Feature Object Expressions
Expression	Description
[@Feature(FeatureABC).ActionState]	Determine whether the Advanced UI or Suite/Advanced UI is installing the FeatureABC feature.
[@Feature(FeatureABC).Cost]	Determine how much space (in bytes) the feature requires.

Feature Object

InstallShield 2016 Help Library

August 2016