Replacing Obsolete Properties and Methods

InstallShield 2019

InstallShield’s simplified model for Internet installations eliminates several methods and properties that the Ether object and its subobjects had in InstallShield Professional 6.x. The following is a list of those methods and properties, and how to replace them if you are converting an InstallShield Professional 6.x installation Web page to work with an InstallShield installation.

AskDestPath

To display the equivalent dialog during the installation, call the InstallScript function AskDestPath in your installation script. To pass a destination path to the installation from the Web page, set a script-defined property.

CommandLine

Replace a line like the following:

ether.CommandLine = "<string value>";

 

with a line like the following:

ether.SetProperty("is::CmdLine","<string value>");Features, SetState

 

To offer the equivalent functionality during the installation, call the InstallScript function SdFeatureTree in your installation script. To pass a feature selection to the installation from the Web page, set a script-defined property; in addition, in the installation script, use its value to conditionally call FeatureSelectItem.

Features, GetState

To get a feature’s selection state during the installation, call the InstallScript function FeatureIsItemSelected in your installation script. A Web page cannot get a feature’s selection state.

FileToOpen

To open a file during the installation, call the InstallScript function LaunchApplication in your installation script. To pass a file name to the installation from the Web page, set a script-defined property.

GetDownloadSize, FileLevelCosting

To get the required disk space during the installation, call the InstallScript function FeatureGetTotalCost in your installation script. (Feature dialogs such as SdFeatureTree display the required disk space.) A Web page cannot get the required disk space.

Language

Replace a line like the following:

ether.Language = "<language code>";

 

with a line like the following:

ether.SetProperty("is::CmdLine","-l<language code>");LegacyMode

 

By default, Internet installations run in legacy mode—that is, with the installation’s user-interface events generated as appropriate. There are two ways to duplicate the effect of setting ether.LegacyMode=false; on your Web page:

Run the installation silently with the following line:

ether.SetProperty("is::CmdLine","-s");

 

Set a script-defined property or check the return value of Is(WEB_BASED_SETUP), and conditionally call the installation’s user-interface event handler functions in the OnShowUI handler.

ProductName

A Web page cannot get this information.

GetTargetDir

A Web page cannot get this information.

GetTextSub

A Web page cannot get this information.

IsInstalled

A Web page cannot get this information.

SetSetupType

To specify a setup type during the installation, call the InstallScript function FeatureSetupTypeSet in your installation script. To display a setup type selection dialog during the installation, call SdSetupType in your installation script. To pass a setup type to the installation from the Web page, set a script-defined property.

SetTargetDir

To specify a target directory during the installation, assign a value to the system variable TARGETDIR in your installation script. To pass the target directory to the installation from the Web page, set a script-defined property.

SetTextSub

To specify a text substitution during the installation, assign a value to the TextSub object’s Value property in your installation script. To pass a text substitution to the installation from the Web page, set a script-defined property.