Keyword Settings for an .ini File

InstallShield 2024 » INI File Changes View » .ini File » Keyword

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

Basic MSI
DIM
InstallScript MSI
Merge Module
MSI Database
MSM Database
Transform

When you select a keyword in the INI File Changes view, several settings are displayed.

.ini File Keyword Settings

Setting

Description

Display Name

Enter the name of the keyword that you would like to edit, exactly as it should appear in the target .ini file.

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.

Action

Select the action that you would like to perform. Valid options are:

Replace Old Value—The existing value is replaced with the value that you enter in the Data Value setting. If it does not exist, the installation creates it.
Do Not Overwrite—Your value is added to the .ini file if the keyword does not already exist. No changes are made if the keyword is already present in the .ini file.
Append Tag—Select this option if you would like to add an additional tag to an keyword value. Tags are comma separated. If the keyword to which you would like to append a tag does not exist, no changes are made.
Remove Whole Value—The keyword and its value are both removed from the .ini file. If the specified keyword does not exist, no changes are made. If you select this option, leave the Data Value setting blank.
Remove Tag—Multiple values for a keyword are known as tags. Tags are separated by commas. To remove a tag from a keyword’s value, select this option. In the Data Value setting, enter the tag that you want to be removed.

Data Value

Enter the value for the keyword. If you are adding or appending a value, enter the new value. If you are removing a tag, enter the tag that you would like to remove. If you are removing the keyword and value, leave this setting blank.

You can use Windows Installer properties in your keyword’s value. To do this, surround the property with square brackets—for example, [INSTALLDIR].

See Also