File Removal Properties Dialog Box

InstallShield 2018

Project • This information applies to the following project types:

•

Basic MSI

•

DIM

•

InstallScript MSI

•

Merge Module

•

MSI Database

•

MSM Database

•

Transform

The file removal Properties dialog box indicates information about a selected file or folder that you want to be removed from target systems. This file and folder removal capability is useful for scenarios such as removing application-created files that your installation does not otherwise track.

You can access the file removal Properties dialog box from within the Files and Folders view, or within the Setup Design view (for installation projects) or the Components view.

To access the file removal Properties dialog box from within the Files and Folders view:

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

In the Destination computer’s folders pane, click the folder that contains the file removal item that you want to configure.

In the Designation computer’s files pane, right-click the file removal item that you want to configure, and then click Properties.

InstallShield uses an icon that has a red X through it for identifying files and folders that are configured to be removed.

To access the file removal Properties dialog box from within the Setup Design view (for installation projects) or the Components view:

In the View List under Organization, click Setup Design (in Basic MSI, InstallScript MSI, or MSI Database projects only) or Components.

In the explorer, expand the component that contains the file removal item that you want to configure, and then click its Files node. In Files pane on the right, InstallShield displays the files and removal items that are associated with the selected component.

In the Files pane, right-click the file removal item that you want to configure, and then click Properties.

InstallShield uses an icon that has a red X through it for identifying files and folders that are configured to be removed.

To learn how to add file and folder removal items to your project, see Removing Files and Folders from Target Systems.

Settings in the Properties Dialog Box

Setting

Description

Location

This setting indicates the location of the selected item that is configured to be removed.

Remove the folder if it is empty

If the selected removal item is a folder that you want to be removed from target systems when it is empty, select this option.

Remove files from the folder

If the selected removal item is a file in the folder that is identified in the Location setting and that you want to be removed from target systems, select this option.

File Name

This setting is available if you select the Remove files from the folder option.

Enter the name of the file that you want to be removed.

When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.

Removal Scheduling

Specify when you want the selected file or folder to be removed from target systems. Removals occur when the file or folder’s associated component is processed in one of the following ways:

•

Component installation—The selected item is removed if its component is being installed and if—for folder removal items—the folder is empty.

•

Component uninstallation—The selected item is removed if its component is being uninstalled and if—for folder removal items—the folder is empty.

•

Component installation and uninstallation—The selected item is removed if its component is being installed or uninstalled and if—for folder removal items—the folder is empty.

File Removal Properties Dialog Box

InstallShield 2018 Help Library

January 2018