File Properties

Settings

Compress file

Compress the file when it's added to the setup executable. If unchecked, the file will not be compressed when it's added.

Turning off compression will decrease the time it takes to install the file, but will result in a larger setup. You may want to turn the compression off if you are distributing your setup on CD-ROM or over a Network where the size is not restricted or if the file is already compressed and you know that you will not be able to get much more compression out of it.

If your installer is being distributed on a very slow medium, such as floppy disks or Zip disks, it may actually be faster to leave compression on, because reading the extra data saved by compression would take more time (especially on floppies) than it does to decompress it.

Note: The Compress file option is not available for files on the External tab.

Suppress "In-Use" notice

Suppress a warning if the file is in use during installation and needs to be overwritten. If a file is in use, the built-in global variable _NeedsReboot will automatically be set to true to notify the setup that a reboot needs to take place.

If unchecked, a message will appear to warn the user if the file is in use and will ask them to shut down any running programs.

Use failsafe copy method

Extract the file to a temporary location, and then copy it to its final destination. This feature helps prevent the file from being corrupted if the install is aborted or if the user's system crashes midway through installing the file.

Note: This feature adds extra time to your installation, and will also increase the amount of temporary disk space required on the user's system during the installation. You should only use this feature for mission critical files, such as system files.

Create backup

Create a backup of the existing file (if present), before overwriting it during the installation. The existing file will be renamed to filename.bak. If filename.bak already exists, it will be named filename.bk1, or filename.bk2, etc. The new file will only be installed after the existing one has been backed up.

Tip: By default, each backed up file is created in the same directory as the target file. However there is a global variable called _BackupFolder that can be set as the backup directory for all files with this option enabled.

Note: Setup Factory does not restore backed up files during the uninstall, however the framework is available if you wish to perform this type of restoration. The full path and filename to each backed up file is stored with the information of the file being installed in the uninstall and can be accessed using the UninstallData.GetItem action.

Disable CRC check

Do not perform the usual CRC value integrity check on the file during installation. In general, you should not turn this option on. The CRC checking that is performed during setup is meant to ensure that your files are properly and completely installed and are not corrupted.

The only reason to turn this option on is if the file that you are installing will change from CD-ROM to CD-ROM and you do not want to re-build the setup each time the file changes. An example of such a file would be a customized data file that changes for each of your customers.

Attributes
 

This section allows you to specify the attributes of the file when it is installed on the user’s system. By default, the Use original option will be selected. This will ensure that the file's attributes will be the same on the user’s system as on yours.

Note: Changing the file attributes in this section does not affect the file on your development system. The attributes are only applied to the file when it's installed.

Use original

Preserve the attributes of the source file when the file is installed. If unchecked, you must specify the attributes for the installed file.

Read-only

Set the read-only file attribute when installed.

Archive

Set the archive file attribute when installed.

Hidden

Set the hidden file attribute when installed.

System

Set the system file attribute when installed.

Priority

Install order

The order in which this file will be installed onto the user's system. Install order defaults to 1000. Files with lower install order values are installed first. This option is useful if certain files need to be installed and registered before others in your install archive.

Note: Archive files are always installed before External files in the install sequence. This install order value only applies to the files on the current tab.

Uninstall

Never remove

Do not remove this file during the uninstall process.

Shared/System file

Update the usage count for this file during installation and uninstallation. This feature should only be used for files that are shared by multiple programs, such as system files.

OLE/ActiveX

Register COM interfaces

Try to register this file if it is a COM Interface file. This will only work for controls that properly support the DLLRegisterServer interface. This option should properly register ActiveX controls (OCX) and other OLE inproc servers.

You can use the Test button located to the right of this checkbox to test the current file and see whether it supports DLLRegisterServer.

Tip: By default if the registration fails, an error dialog is shown (if the install is not running in silent mode). If an error occurs, the function g_OnRegisterFileFailed is called. If you would like to suppress this error message or handle the way Setup Factory handles this situation, you can modify this function defined in the file _SUF70_Global_Functions.lua located in the Includes\Scripts folder of the main Setup Factory 7.0 folder. The preferred method is to redefine the function in your project by copying and pasting it into the Resources > Global Functions and then making the desired modifications.

Register TypeLib

Try to register this file if it is a TypeLib file.

Font

Register as TrueType font

Try to automatically register and implement this file as a TrueType font during installation. This means that the font will be registered with the operating system and will be made available to the user. In order for this to work, the file must be a valid Windows .TTF file.

Font name:

The name that will be entered in the registry for the TrueType font.

You can click the Auto-Name button below this field to automatically scan the file and try to determine its embedded name. If the Auto-Name returns "Unknown" then the file is most likely not a valid Windows .TTF file.