The Set Feature State action changes the state of its target feature. It can select, unselect, enable or disable the target feature; any changes made through this action are reflected in the active FeatureTree control, if any. See New state (below) for the complete list of settable states.
Note: The new feature state is maintained until changed by the user through a FeatureTree control or by the installer through another Set Feature State action. In addition, if the InitFeatures standard action is executed, all features are reset to their initial or conditional state.
This pane contains the following attributes and options.
| Attribute | Description |
|---|---|
| Action name | Enter the name of the action. This name is only used in Tarma Installer and is not visible to the user. |
| Description | Enter the localizable description of the action. This description is displayed in progress messages in the installer while the action is executing. |
| New state | Select the desired new feature state. The available states are explained under New state, below. |
| Feature | Select the desired target feature by clicking the ... (browse) button to the right of this field to open the Select Product Feature dialog box that allows you to select the desired feature. |
| Condition | Enter the conditional expression that determines if the action will be executed, or leave empty for unconditional execution. |
| Platforms... | Click this button to open the Select Installation Platforms dialog box that allows you to select the Windows versions on which the action must be executed. This platform selection acts as an additional condition for the action. |
| Disabled | Check this box to disable the action. A disabled action is not included in the installer and not checked during the build. You can use this option to remove actions temporarily from your installer without permanently deleting them. Disabled actions are shown with a grayed-out icon. |
The following new feature states can be set by this action. With the exception of Default and Toggle, they are the same as the states available in the feature attributes.
| New state | Description |
|---|---|
| Default | Resets the feature to its default state, which is either the Initial state or the New state as determined by the feature attributes and the current evaulation of the feature's Condition. Tip: This state action is useful to re-initialize a single feature if you know that its Condition might have changed. To re-initialize all features, use the InitFeatures standard action instead. |
| Unavailable | The feature is unavailable and will not be displayed in the installer's user interface. Note: This only applies if the feature state is set before a FeatureTree control is shown. If the feature state changes to Unavailable while the control is present, the feature will be shown as Disabled. |
| Disabled | The feature is unavailable, but displayed in the installer's user interface. |
| Not selected | The feature is available, but not selected. |
| Selected | The feature is selected. |
| Always selected | The feature is selected and cannot be unselected. |
| Toggle | The feature's state toggles between Selected and Not selected if it currently is in one of those states; otherwise the state doesn't change. This is equivalent to the user selecting a feature in the active FeatureTree control, if any. |