Change Settings

InstallShield 2019 » 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.

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.

Tip • You can enter escape sequence characters in this field to specify line breaks or tabs. See Parse Escape Sequences for more information.

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.

Parse Escape Sequences

Specify Yes if you want the installer to parse escape sequence characters in the Replace With string. The following escape sequence characters are supported:

New line (\r\n )
Tab (\t)

See Also