SHELL_OBJECT_FOLDER

InstallShield 2016 » InstallScript Language Reference

Project • The following project types support SHELL_OBJECT_FOLDER:

The SHELL_OBJECT_FOLDER system variable is used to specify the name of a shell object folder—typically a Start Menu folder—at run time through script.

You can specify SHELL_OBJECT_FOLDER (for InstallScript or InstallScript MSI projects) or <SHELL_OBJECT_FOLDER> (for InstallScript projects) in the Display Name setting for a folder in the Shortcuts view. Then you can define the display name for the folder at run time by setting the SHELL_OBJECT_FOLDER variable in your script before the shortcut is created. The shortcut is typically created during file transfer.

Project • For InstallScript projects, you can specify either <SHELL_OBJECT_FOLDER> or SHELL_OBJECT_FOLDER in the Display Name setting. In both cases, text substitution is used. However, including the angle brackets—<SHELL_OBJECT_FOLDER>—is recommended.

For InstallScript MSI projects, you must specify SHELL_OBJECT_FOLDER (without the angle brackets).

To use this functionality in an InstallScript MSI installation, any letters that are specified for the Key Name setting of the folder in the Shortcuts view must be all uppercase (for example, NEWFOLDER1).

If the installation is not in maintenance mode, SHELL_OBJECT_FOLDER is initialized to the same value as IFX_PRODUCT_NAME during initialization of the InstallScript engine. Note that these variables are not synchronized once initialized; therefore, if you change one and want the other to change, you must change both manually. These types of manual changes are logged, and the changes are read from the log on subsequent maintenance operations. Therefore, a shortcut that uses the SHELL_OBJECT_FOLDER variable for its display name can be removed during uninstallation.

See Also

IFX_PRODUCT_NAME

Open topic with navigation