MSI Factory 2.3

Feature Properties

Feature Properties

Previous topic Next topic  

Feature Properties

Previous topic Next topic  

MSI Factory

Feature

Identifier:

The unique identifier of the feature. The identifier must not exceed 38 characters in length.

Level:

The default level of the feature between 0 and 32,767. A value of 0 will disable the feature. For any installer there is a set installation level at install time. The initial value is determined by the INSTALLLEVEL property. A feature is only installed if the feature level is less than or equal to the current install level. The default value of INSTALLLEVEL is 1. During installation the install's install level can be set from a dialog with the SetInstallLevel control event. You should usually set the level of your features to 1 unless you plan on supporting different install types such as "Typical, Minimum, Complete, etc."

You can also set install levels of a feature conditional by defining conditional levels. To configure conditional levels, click the Conditional Levels button to open the Condition Levels dialog.

For more details about install levels see the "Remarks" section of the "Feature Table" MSDN Online topic linked to below.

User Interface

Title:

The name of the feature as it will appear in the SelectionTree control on a dialog. You use a message ID here to support a localized title.

Description:

Longer string of text describing the feature. You use a message ID here to support a localized description.

Initial display state:

Determines the initial display of this feature in the feature tree. choose from one of the following:

Collapsed

Initially shows the feature collapsed. This is the default value.

Expanded

Initially shows the feature expanded.

Hidden

Prevents the feature from displaying in the dialog, although the feature will still exist and be processed.

Advertising

Allow advertise ("Feature will be installed when required")

If checked, the feature will allow advertising. That is, the user will be able to select "Feature will be installed when required" from the options of the Selection Tree in the dialog interface. You should only allow advertising for a feature if it contains a component that has an advertised shortcut, class, AppId, TypeLib, etc. or if your software supports install on demand through the MSI interface. In fact, if you do not have an advertised item in a child component, advertising will not be allowed anyhow.

Only allow advertise if supported by system (Recommended)

If checked, the feature will only allow advertising if the operating system supports it. You should generally leave this option on. This option is only applicable if Allow advertise is checked.

Advertised is default state

If checked, the feature will be marked to be advertised by default. This option is only applicable if Allow advertise is checked.

Options

Allow absent (Allow the "Do not install")

If checked, the user will have the option to set a feature to absent in the user interface. If unchecked, the feature will be forced to the installation state whether or not it is visible in the user interface.

Default install location:

Determines the default install/run location of a feature in the user interface. Note that the run from options of a feature is really determined by the feature's components' Location setting (General tab of Component Properties dialog). Choose from:

Use parent feature's setting

Forces the feature to follow the same installation state as its parent feature.

Install to local hard drive

Favors installing the feature locally.

Run from source

Favors running the feature from the source (usually network drive setup by an administrative installation).

Enable browse for folder

If checked, the user will be able to configure a local path of a specific folder. Usually it is the folder that the feature will be installed to.

Target folder to browse for:

The folder ID that should be set by the user when they browse for a folder during installation. You can right-click in the field and select Insert > Folder ID, or click on the Browse button to select a folder identifier from the Folders dialog.

Note: This Folder ID must be a public property and therefore must be all uppercase.

More Information

MSDN Online: Controlling Feature Selection States

MSDN Online: Feature Table

MSDN Online: INSTALLLEVEL Property

WiX Help File: Feature Element


Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us