Property Comparison Condition Settings

InstallShield 2019

Project • This information applies to the following project types:

•

Advanced UI

•

Suite/Advanced UI

Edition • The Advanced UI project type is available in the Professional edition of InstallShield. The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects.

When you are building a conditional statement for an exit, detection, eligibility, feature, or wizard interface condition in an Advanced UI or Suite/Advanced UI project, or for an action condition in a Suite/Advanced UI project, you can create a Property Comparison condition. The Property Comparison setting shows the condition that is configured for checking the value of a particular built-in Advanced UI or Suite/Advanced UI property, or a property that is defined in the Property Manager view. To define this type of condition, configure the subsettings under the Property Comparison setting as needed.

The following subsettings are available for this condition.

Property Comparison Condition Settings

Setting

Description

Name

To create a conditional statement that checks the value of a particular Advanced UI or Suite/Advanced UI property, enter the name of the property in this setting.

For a list of built-in conditions, see Advanced UI and Suite/Advanced UI Property Reference.

Conversion

Select the type of value that you want to compare. Available options are:

•

DWORD—The value that you want to compare is a DWORD (32-bit) value.

•

QWORD—The value that you want to compare is a QWORD (64-bit) value.

•

String—The value that you want to compare is a string value.

•

File Version—The value that you want to compare is a file version value in the format nn.nn.nn.nn.

•

Product Version—The value that you want to compare is a product version value. The typical format for the version number is aaa.bbb.ccccc or aaa.bbb.ccccc.ddddd, where aaa represents the major version number, bbb represents the minor version number, ccccc represents the build number, and ddddd represents the revision number. Note that although you can include the fourth field (ddddd) when you specify the product version, the Advanced UI or Suite/Advanced UI installation does not use this part of the product version to distinguish between different product versions.

•

Local Date Time—The value that you want to compare is a date or a date and time.

Comparison

Select the option that describes how you want to compare the value of the property at run time on the target system with the value that you specify in the Compare To setting. For example, consider a property comparison condition in which the value of the Conversion setting is String, the value of the Comparison setting is Equal, and the value of the Compare To setting is MyValue. At run time, this condition evaluates as true if the property value at run time is MyValue; it evaluates as false if the property value is not set or is any other value.

Compare To

Specify the value that you want to compare with the value of the Advanced UI or Suite/Advanced UI property on the target system at run time. The value that you enter depends on the option that is selected for the Conversion setting:

•

If DWORD is selected in the Conversion setting, enter the DWORD value that you want to compare in the Compare To setting.

•

If QWORD is selected in the Conversion setting, enter the QWORD value that you want to compare in the Compare To setting.

•

If String is selected in the Conversion setting, enter the string value that you want to compare in the Compare To setting.

•

If File Version is selected in the Conversion setting, enter the file version value (in the format nn.nn.nn.nn) that you want to compare in the Compare To setting.

Compare To (continued)

•

If Product Version is selected in the Conversion setting, enter the product version value that you want to compare in the Compare To setting. The typical format for the version number is aaa.bbb.ccccc or aaa.bbb.ccccc.ddddd, where aaa represents the major version number, bbb represents the minor version number, ccccc represents the build number, and ddddd represents the revision number. Note that although you can include the fourth field (ddddd) when you specify the product version, the Advanced UI or Suite/Advanced UI installation does not use this part of the product version to distinguish between different product versions.

•

If Local Date Time is selected in the Conversion setting, enter the date and time that you want to compare in the Compare To setting—for example, 4/26/2004 3:57:46 PM.

When you type a value for this setting, you can include one or more formatted expressions that contain property names, environment variable references, and other special strings; at run time, the installation expands the values of these expressions. To learn about the syntax that is available for these expressions, see Using Formatted Expressions that Advanced UI and Suite/Advanced UI Installations Resolve at Run Time.

The Comparison setting is where you indicate how you want to compare the value of the property at run time on the target system with the value that you specify in the Compare To setting. For example, consider a property comparison condition in which the value of the Conversion setting is String, the value of the Comparison setting is Equal, and the value of the Compare To setting is MyValue. At run time, this condition evaluates as true if the property value at run time is MyValue; it evaluates as false if the property value is not set or is any other value.

Property Comparison Condition Settings

InstallShield 2019 Help Library

April 2019