File Properties Dialog Box

InstallShield 2014

Project: This information applies to the following project types:

•

Basic MSI

•

DIM

•

InstallScript MSI

•

Merge Module

•

MSI Database

•

MSM Database

•

Transform

The Properties dialog box lets you override various properties for a file when it is installed on the target system.

To open the File Properties dialog box:

In the View List under Application Data, click Files and Folders.

Right-click a file and click Properties.

Important: File properties cannot be set for dynamically linked files.

Properties Dialog Box Settings

Setting

Description

Location

This read-only setting displays the directory in which this file will be installed on a target system, based on the destination of the component that contains the file.

To modify the destination, change the destination of the component that contains the file.

Font title

If you are installing a font, you can specify the font title in this box using the format FontTitle (FontType)—for example, Roman (All res). InstallShield provides the name of the font if it is registered on your system.

You should not specify a font title for .ttf or .ttc fonts because Windows Installer reads the embedded font name and registers it for you. Thus, for .ttf or .ttc files, InstallShield sets the value of this setting to [Title read from file].

For more information, see ICE07 in the Windows Installer Help Library.

Self Register

To self-register the file during installation, select this check box. The Self Register setting is valid for .dll, .ocx, .exe, .tlb, and .olb files.

If the file is part of a 64-bit component, the installation performs 64-bit self-registration on the target system. For more information, see Targeting 64-Bit Operating Systems.

Note: It is recommended that you extract COM information from your self-registering files, instead of using self-registration. For more information, see Registering COM Servers.

Override system attributes

To install this file using the same system properties that are currently set for this file on the development system, clear this check box.

To override one or more of the file’s properties, select the Override system attributes check box and then select one or more of the following check boxes.

•

Read-only—If you want the file to be read-only when Windows Installer installs it, select this check box.

•

Hidden—If you want the file to be hidden when Windows Installer installs it, select this check box.

•

Use File Hash—This option is applicable for unversioned files only. Windows Installer can use file hashing to detect and avoid unnecessary copying of unversioned files. If you want Windows Installer to compare the hash of the file in your installation with the hash of the corresponding file on the target system when deciding whether to upgrade an existing file, select this check box.

•

System—If you want Windows Installer to install the file as a system file, select this check box.

•

Vital—To indicate that this file is vital to the operation of its component, select this check box. A vital file’s component is not installed if the file cannot be installed for any reason. If a vital file cannot be installed, the end user sees an error message with Retry and Cancel buttons, instead of the usual Abort, Retry, and Ignore buttons (which enable the end user to complete the installation successfully without installing that file).

Note: If No is selected for the Generate File Hash Values setting on the Build tab for a release in the Releases view, no file hash entries are created for any files, regardless of whether an individual file’s Use File Hash check box is selected.

Override system size

The Size setting shows the file’s size when the Override system size setting is cleared.

If you want Windows Installer to ignore the actual size of the selected file when it is calculating the required disk space requirements for your installation, and instead consider the size to be a value that you specify, select this check box and enter the appropriate value (in bytes) in the Size setting.

Always Overwrite

If you want Windows Installer to ignore the actual version number of the selected file, and instead always try to overwrite the file if it is already present on the target system, select this check box. At run time, if this file has the same name and target location as one on the target system, Windows Installer considers the version of the file in your installation to be 65535.0.0.0 when it is determining whether to update the target system’s file with the version in your current installation, or to leave the file as is.

For more details about how Windows Installer determines whether to overwrite an existing file, see Overwriting Files and Components on the Target System.

The maximum version number for a file is 65535.65535.65535.65535.

Override system version

If the file is a versioned file, the Version setting shows the file’s version when the Override system version setting is cleared.

If you want Windows Installer to ignore the actual version number of the selected file, and instead consider the version to be a number that you specify, select this check box and enter the appropriate version number in the Version setting. At run time, if this file has the same name and target location as one on the target system, Windows Installer uses the version number that you specify when it is determining whether to update the target system’s file with the version in your current installation, or to leave the file as is.

For example, if the file in your project is version 2.0.0.0, and you enter an override version of 3.0.0.0, Windows Installer may replace the file on the target system if it is version 3.0.0.1 or later, but not if it is earlier than 3.0.0.0.

For more details about how Windows Installer determines whether to overwrite an existing file, see Overwriting Files and Components on the Target System.

The maximum version number for a file is 65535.65535.65535.65535.

Override system language

If you want Windows Installer to ignore the language of the selected file and instead consider the language to be one that you specify, select this check box and type the decimal value for the language identifier code in the Language box. At run time, if this file has the same name and target location as one on the target system, Windows Installer considers the language of the file in your installation to be the one that you specified when it is determining whether to update the file with the version in your current installation, or to leave the file as is.

For more details about how Windows Installer determines whether to overwrite an existing file, see Overwriting Files and Components on the Target System.

Font files should not be authored with a language ID because fonts do not have an embedded language ID resource. Leave this entry blank for font files.

Permissions

To set permissions for the file, click this button.

File Properties Dialog Box

InstallShield 2014 Help Library

May 2014