Add New Property Dialog Box

InstallShield 2024

Project: This information applies to the following project types:

InstallScript
InstallScript Object

The Add New Property dialog box lets you specify the name and attributes of a new property and automatically paste corresponding code into your script. This dialog box opens when you right-click the InstallScript view’s Properties folder and then click Add New Property.

Add New Property Dialog Box Settings

Setting

Description

Property Name

This is the global name of this property. Therefore, when trying to read from or write to this property from script, you will need to use this name. The name you enter in this box will be appended to the local variable name property.

Data Type

Select String, Number, or Boolean, depending on the type of data that your property requires. The local variable name will change depending on the selection that you make.

Access Method

Select the appropriate level of access for the property. Available options are Read/Write, Read Only, and Write Only.

Array

If your property is an array, select this check box.

Note:If you plan on using the InstallShield stock wizard for your object’s design-time interface, you cannot use array properties. You can create a custom wizard that accepts array properties or you can redesign the property without using an array.

Local Variable Name

You can accept the default name or create your own variable name. This variable name is used when calling your variable from within the script.

Default Value

Enter the starting value for your property. Be sure to match the value to the data type that you chose. When you are specifying a string value, type it exactly as you would in the script; enclose the string value in quotation marks and use the appropriate escape sequences for special characters (for example, enter a backslash as \\). Do not enter a string identifier or a system variable in an InstallScript Object project; the initialization of the property’s value is performed when the object is added to a project, at which time string identifiers and system variables are not yet initialized.