Property Manager View

InstallShield 2019

Project • The Property Manager view is available in the following Windows Installer–based projects:

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

This view is also available in Advanced UI and Suite/Advanced UI projects.

Note that some differences between the Property Manager view in Windows Installer–based projects and that in Advanced UI and Suite/Advanced UI projects exist; these differences are noted where appropriate.

The Windows Installer engine and the Advanced UI and Suite/Advanced UI engine maintain global information using properties. The Property Manager view displays a list of installation properties that are used by the Windows Installer engine or the Advanced UI and Suite/Advanced UI engine at run time. You can modify, create, and delete installer properties in the Property Manager view. At build time, InstallShield writes the properties in the Property Manager view to installation that it creates.

Following is a list of some of the tasks that you can perform in this view:

View the properties that are defined in your project.
Add, modify, and delete properties.
Filter the properties that are shown in the view to hide ones that do not contain a specific string.
Resize and reorder the columns in the view.
Sort the rows in the view by any column by clicking the column heading.
Drag and drop column headings on to the group box area (the area below the view’s buttons) to organize the rows in the view in a hierarchical format.
Windows Installer–based projects: Make a property localizable so that it can have different values based on the language that your installation uses.

Project • In Windows Installer–based projects, properties that appear in all uppercase letters are called public properties, and they can be changed by the end user on the command line at run time. All others must be set before the release is built or—at run time—through a custom action or dialog’s behavior.

Working with the Property Manager View

The Property Manager view consists of the following elements:

A row of buttons and other controls
A group box area (below the row of buttons)
A spreadsheetlike table

Each row in the table represents a property in your project.

The following table describes all of the buttons and other controls that are displayed in the Property Manager view.

Controls in the Property Manager View

Name of Control

Icon

Description

New Property

Adds a new property to your project.

Project • In Windows Installer–based projects: To create a localizable property, you can click the arrow next to this button, and then click Localizable Property. To learn more, see Creating a Localizable Property.

Delete Selected Properties

Deletes the selected row or rows.

Clear Selected Properties

Deletes the value of the selected properties.

Make Selected Properties Localizable

Project • This button is available in Windows Installer–based projects.

Adds a string identifier to the value of the selected properties, enabling you to set a different property value for every language that your project supports. To learn more, see Making an Existing Property Localizable.

Expand All Groups

Shows all of the rows in the groups if you are using groups to organize the rows in a hierarchical format.

Collapse All Groups

Hides all of the rows in the groups if you are using groups to organize the rows in a hierarchical format.

Search Grid

 

Dynamically filters the properties that are displayed in the Property Manager view according to the string that you specify in this search box. As you type a string in this box, InstallShield hides all of the rows that do not contain it.

Property Manager Help

Displays the help for the Property Manager view.

Drag a column header here to group that column

 

Use this group box area to group rows in the view. The view supports multiple levels of grouping simply by dragging the column headings and dropping them onto the group box. InstallShield displays the rows in the view hierarchically according to column arrangement in the group box.

To learn more, see Working with the Group Box Area in Various Views.

The following table describes each of the columns in the Property Manager view.

Columns in the Property Manager View

Column

Description

Name

This column shows the name of the Windows Installer or Advanced UI and Suite/Advanced UI property.

Value

This column shows the value of the property.

Project • In Windows Installer–based projects: If the property is configured to be localizable, this column shows the string identifier in curly brackets before the string value.

Comments

This column contains an internal note about the properties. The comments are not displayed at run time.

Formatted

Project • This column is available in the following project types:

Advanced UI
Suite/Advanced UI

This column contains a check box that lets you indicate whether the value in the Value column is a formatted expression that contains property names, environment variable references, or other special strings that you want to be resolved at run time. The run-time resolution occurs early at run time, before the installation executes the actions in the OnBegin event.

To leave the property value as is at run time, clear this check box. Square brackets and other characters have no special meaning.

To replace the formatted expressions at run time, select this check box.

To learn about the syntax that is available for formatted expressions, see Using Formatted Expressions that Advanced UI and Suite/Advanced UI Installations Resolve at Run Time.

See Also