Change Settings

InstallShield 2016 » Text File Changes » Change

Project • The Text File Changes view is available in the following project types:

•

Basic MSI

•

DIM

•

InstallScript MSI

•

Merge Module

•

MSI Database

•

Transform

This view is not available in InstallScript projects; however, the InstallScript language includes string functions for finding and modifying string variables and literals.

When you select a change item in the Text File Changes explorer of the Text File Changes view, the following settings are available for you to configure.

Change Settings

Setting

Description

Action

Specify the type of change that you want to make in the applicable text file or files on target systems. Available options are:

•

Replace—Search for existing text and replace it.

•

Insert at Beginning of File—Add text to the beginning of the file.

•

Insert at End of File—Add text to the end of the file.

•

Insert Before Text—Search for existing text and add text before it.

•

Insert After Text—Search for existing text and add text after it.

Find What

This setting is available for the following types of text change actions:

•

Replace

•

Insert Before Text

•

Insert After Text

Enter the string that you want to change, or select a Windows Installer property from the list. The list consists of all of the properties that are available in the Property Manager view of your project.

Tip • You can use Windows Installer public properties to specify the search strings and the replacement strings. This enables you to use data that end users enter in dialogs, or other configuration information that is determined at run time, when your product’s text files are modified at run time. To learn more, see Using Windows Installer Properties to Dynamically Modify Text Files.

Replace With

This setting is available for the Replace type of text change action.

Enter the new string that should replace the existing string that is found, or select a Windows Installer property from the list. The list consists of all of the properties that are available in the Property Manager view of your project.

Insert Text

This setting is available for the following types of text change actions:

•

Insert at Beginning of File

•

Insert at Beginning of File

•

Insert Before Text

•

Insert After Text

Enter the new string that should be inserted into the text file or files.

Tip • You can use Windows Installer public properties to specify the search strings and the inserted strings. This enables you to use data that end users enter in dialogs, or other configuration information that is determined at run time, when your product’s text files are modified at run time. To learn more, see Using Windows Installer Properties to Dynamically Modify Text Files.

Match Whole Word Only

This setting is available for the following types of text change actions:

•

Replace

•

Insert Before Text

•

Insert After Text

Specify whether you want to find only whole-word instances of the value that you have entered for the Find What setting. For example, if you specify Yes and you enter install for the Find What setting, the installation searches only for instances of install; it does not search for other forms of the word, such as installs, installation, or uninstall.

Match Case

This setting is available for the following types of text change actions:

•

Replace

•

Insert Before Text

•

Insert After Text

Specify whether you want to restrict your search to strings with the same capitalization that you use in the Find What setting.

For example, if you specify Yes and you enter install for the Find What setting, the installation searches only for all-lowercase instances of that string. If you select No, the installation searches for install, as well as INSTALL, Install, and other mixed-case instances.

Replace Only Once

This setting is available for the Replace type of text change action.

Specify whether you want the installation to replace only the first occurrence of the search string.

If you specify No, the installation replaces all instances of the search string.

Insert Only Once

This setting is available for the following types of text change actions:

•

Insert Before Text

•

Insert After Text

Specify whether you want the installation to insert the text at only the first occurrence of the search string.

If you specify No, the installation adds the string for all instances of the search string.

Change Settings

InstallShield 2016 Help Library

August 2016