Customizing File Properties for the Setup Launcher

InstallShield 2012 Spring

Project: This information applies to the following project types:

Advanced UI
Basic MSI
InstallScript
InstallScript MSI
Suite/Advanced UI

Note that project-specific differences are noted where applicable.

InstallShield lets you use custom information for the version resources of the Setup.exe setup launcher. The information is displayed on the Properties dialog box for the setup launcher; this Properties dialog box opens when end users right-click the Setup.exe file and then click Properties.

Settings in InstallShield that Let You Configure Setup.exe Properties

The following table lists various properties that Windows includes on the Properties dialog box, along with the corresponding settings in InstallShield that you can use to configure them.

Note: The Properties dialog box is different on different versions of Windows. For example, on Windows 7 systems, the version resource information is displayed on the Details tab of the Properties dialog box. However, on Windows XP systems, the version resource information is displayed on the Version tab of that dialog box.

Also note that some versions of Windows do not show some settings on the Properties dialog box.

Source of Information for Setup.exe Properties

Setup.exe Property

InstallShield Setting that Configures the Setup.exe Property

Company Name

The setting that contains the value for this field varies, depending on the project type that you are using.

In Basic MSI and InstallScript MSI projects: Publisher setting in the General Information view.
In InstallScript projects: Company Name setting in the General Information view.
In Advanced UI and Suite/Advanced UI projects: InstallShield uses either a custom value that you provide, or a default InstallShield-specific name.

If you want InstallShield to use your own custom value for the company field in an Advanced UI or Suite/Advanced UI project:

1. In the Releases view, select the release that you want to configure.
2. On the Setup.exe tab, in the Use Custom Version Properties setting, select Yes.
3. In the Company setting, enter the text that you want to use for the company field in the properties of your Setup.exe file.

If you select No for the Use Custom Version Properties setting or you leave the Company setting blank, InstallShield uses the Publisher setting in the General Information view. If that setting is blank, InstallShield uses the default InstallShield-specific name.

Product Name

The setting that contains the value for this field varies, depending on the project type that you are using.

In Basic MSI and InstallScript MSI projects: Product Name setting for the product configuration in the Releases view. If that setting is blank, InstallShield uses the Product Name setting in the General Information view.
In Advanced UI, InstallScript, and Suite/Advanced UI projects: Product Name setting in the General Information view.

Product Version and File Version

The setting that contains the value for these fields varies, depending on the project type that you are using.

In Basic MSI and InstallScript MSI projects: Product Version setting for the product configuration in the Releases view. If that setting is blank, InstallShield uses the Product Version setting in the General Information view.
In InstallScript projects: Product Version setting in the General Information view.
In Advanced UI and Suite/Advanced UI projects: Product Version setting in the General Information view. You can use the Releases view to override this value.

Note that the file version always contains four fields. If you specify fewer than four fields for your product version, the remaining fields are filled with zeros. For example, if you specify a product version of 1.1, the file version that is used in the version resources of Setup.exe is 1.1.0.0.

If you want to override the value in the General Information view in an Advanced UI or Suite/Advanced UI project:

1. In the Releases view, select the release that you want to configure.
2. On the Setup.exe tab, in the Use Custom Version Properties setting, select Yes.
3. In the Version setting, enter the value that you want to use for the version fields in the properties of your Setup.exe file.

If you select No for the Use Custom Version Properties setting or you leave the Version setting blank, InstallShield uses the Version setting in the General Information view. If that setting is blank, InstallShield uses the default InstallShield-specific values.

Copyright

InstallShield uses either a custom value that you provide, or the default InstallShield copyright notice.

If you want InstallShield to use your own custom value for the copyright field:

1. In the Releases view, select the release that you want to configure.
2. On the Setup.exe tab, in the Use Custom Version Properties setting, select Yes.
3. In the Launcher Copyright setting, enter the text that you want to use for the copyright field in the properties of your Setup.exe file.

If you select No for the Use Custom Version Properties setting or you leave the Launcher Copyright setting blank, InstallShield uses the default InstallShield copyright notice.

File Description

InstallShield uses either a custom value that you provide, or the default InstallShield Setup.exe description.

If you want InstallShield to use your own custom value for the description field:

1. In the Releases view, select the release that you want to configure.
2. On the Setup.exe tab, in the Use Custom Version Properties setting, select Yes.
3. In the File Description setting, enter the text that you want to use for the description field in the properties of your Setup.exe file.

Project: In an Advanced UI, InstallScript, or Suite/Advanced UI project—If you select No for the Use Custom Version Properties setting or you leave the File Description setting blank, InstallShield uses the default InstallShield Setup.exe description.

In a Basic MSI or InstallScript MSI project—If you select No for the Use Custom Version Properties setting, InstallShield uses the default InstallShield Setup.exe description. If you select Yes but leave the File Description setting blank, InstallShield uses the value for the Comments setting of the product configuration in the Releases view. If that setting is blank, InstallShield uses the Summary Information Stream Comments setting in the General Information view. If that setting is blank, InstallShield uses the default InstallShield Setup.exe description.

Language

For this field, InstallShield uses the language that is specified in the Default Language setting for the release in the Releases view that you are building.

Sample Setup.exe Properties Dialog Boxes

Sample Properties for Setup.exe on a Windows 7 Machine

Sample Properties for Setup.exe on a Windows XP Machine

See Also