Shortcut Settings

InstallShield 2019 Express Edition » Shortcuts/Folders View

The settings for a shortcut are organized into the following main categories in the Shortcuts/Folders view:

Appearance
Behavior
General

Appearance

Use a shortcut’s Appearance settings to specify details such as the description and the icon for the shortcut.

Appearance Settings

Setting

Description

Display Resource

If you are preparing an installation for a multilingual application and you are separating language-neutral portable executable files from .mui files for the display name of your shortcut, use the following settings:

Display Resource—Click the ellipsis button (...) in this setting if you want to browse to the DLL file that contains the multilingual user interface (MUI) manifest.

InstallShield lists the path and file name in this setting if you do either of the following: you select a DLL file by browsing for it, or you manually enter a path and file name in the Display Resource DLL setting. InstallShield also lists the resource index that is specified in the Display Resource Index setting.

Display Resource DLL—If you want to manually specify the path and file name of the DLL file that contains the MUI manifest, enter it. You can include Windows Installer directory properties—for example, [INSTALLDIR]MyResource.dll—instead of hard-coded directory paths.

If you click the ellipsis button in the Display Resource setting to browse to the DLL file, InstallShield uses the format [#filekey] in the Display Resource DLL setting to identify the DLL file.

Display Resource Index—Specify the display name index for the shortcut. This must be a non-negative number.

Note • If you specify a DLL, you must also enter a value for the Display Resource Index setting.

These settings enable you to separate language-neutral portable executable files from .mui files, which contain all of the language-dependent resources, and later add resources for additional languages without having to recompile or relink the application.

Windows Vista and later and Windows Server 2008 and later include support for the display resource. Earlier systems ignore it.

Description

Enter a description of the shortcut. The text that you enter is displayed as a tooltip when the end user places the mouse pointer over the shortcut. It is also displayed in the Description field of the shortcut’s Properties dialog box.

Description Resource

If you are preparing an installation for a multilingual application and you are separating language-neutral portable executable files from .mui files for the description of your shortcut, use the following settings:

Description Resource—Click the ellipsis button (...) in this setting if you want to browse to the DLL file that contains the multilingual user interface (MUI) manifest.

InstallShield lists the path and file name in this setting if you do either of the following: you select a DLL file by browsing for it, or you manually enter a path and file name in the Description Resource DLL setting. InstallShield also lists the resource index that is specified in the Description Resource Index setting.

If this setting contains a value, the value for the Description setting is ignored. If you leave this setting blank, Windows Installer uses the value for the Description setting.

Description Resource DLL—If you want to manually specify the path and file name of the DLL file that contains the MUI manifest, enter it. You can include Windows Installer directory properties—for example, [INSTALLDIR]MyResource.dll—instead of hard-coded directory paths.

If you click the ellipsis button in the Description Resource setting to browse to the DLL file, InstallShield uses the format [#filekey] in the Description Resource DLL setting to identify the DLL file.

Description Resource Index—Specify the description index for the shortcut. This must be a non-negative number.

Note • If you specify a DLL, you must also enter a value for the Description Resource Index setting.

These settings enable you to separate language-neutral portable executable files from .mui files, which contain all of the language-dependent resources, and later add resources for additional languages without having to recompile or relink the application.

Windows Vista and later and Windows Server 2008 and later include support for the description resource. Earlier systems ignore it.

Icon

To specify the icon that you want to be displayed for the shortcut, use the following settings:

Icon—Specify the file that contains the icon for the shortcut that you are creating. You must specify an .ico file or the executable file (.dll or .exe) that contains the icon resource. InstallShield lists the icon path and index in the Icon setting if you do either of the following: you select a file by clicking the ellipsis button (...) in this setting and browsing for it, or you manually enter a path and file name in the Icon File setting.
Icon File—If you want to manually specify the path and name of the file that contains the icon, enter it.
Icon Index—If the icon file that you specify contains more than one icon resource, enter the index in this setting.

A nonnegative integer refers to the order of the icon resources in the executable file. For example, 0 refers to the first icon in the file, 1 refers to the second icon, and 2 refers to the third icon.

Use a negative number to refer to a specific resource ID. For example, the icon index -12 points to the icon with a resource ID of 12.

Behavior

Use a shortcut’s Behavior settings to specify details such as the target and keyboard shortcut.

Behavior Settings

Setting

Description

Target

Enter the path to the file on the target system that should be launched when end users launch the shortcut. Use Windows Installer directory properties—for example, [INSTALLDIR]File.exe—instead of hard-coded directory paths. As an alternative to manually entering a value, you can click the ellipsis button (...) to browse to the shortcut target.

Arguments

Enter the command-line arguments for the shortcut. The arguments are added to the Target value on the shortcut’s Properties dialog box on the target system. These arguments work in the same way as any other command-line arguments. For example, you can link a file to an executable file or cause an executable file to run silently by passing command-line arguments.

Note • Verify that the syntax is correct because InstallShield does not do this.

Tip • Use %1 in the argument for the selected file name. For example, if the end user right-clicks the file C:\File.ext and -p %1 is the argument for this shortcut, the command-line argument becomes -p C:\File.ext. In some cases, it is necessary to enclose the %1 argument in quotation marks—as in "%1"—to correctly handle file names that contain spaces.

Working Directory

Enter the working directory for the shortcut target, or click the ellipsis button (...) to select or create a directory.

The directory that you specify is displayed as the Start in field on the shortcut’s Properties dialog box on the target system. The working directory is the default directory that is displayed in standard file-opening and file-saving dialog boxes, as well as the current directory used by the product.

Project • For example, if you want your working directory to be set to a subdirectory of INSTALLDIR called Files, select [INSTALLDIR] from the list and add the subdirectory name Files to the end of it. When you are finished, it should read [INSTALLDIR]Files.

Hot Key

This setting contains the decimal value of the keyboard shortcut that is assigned to your shortcut. You can assign a keyboard shortcut to your product’s shortcut so that end users can press the appropriate hot keys to launch the shortcut.

If you want InstallShield to calculate the decimal value of the keyboard shortcut, click the ellipsis button (...) in this setting.

For more information, see Specifying a Keyboard Shortcut for Accessing a Shortcut.

Caution • It is recommended that you avoid configuring keyboard shortcuts for your shortcuts because they may conflict with existing keyboard shortcuts on the target system.

Run

Select the style of window that the target file should use when end users launch the shortcut. Available options are:

Normal Window—The file is launched in a standard-sized window.
Maximized Window—The file is launched in full-screen view.
Minimized Window—The file is launched in a minimized window, visible only on the taskbar.

Run As Administrator

Select to set the shortcut to “Run As Administrator”.

Available options are:

Yes—Enables the shortcut to Run As Administrator.
No—To not to set the shortcut to Run As Administrator.

Note • An installer should run in an Elevated mode in order to set the shortcut with Run as Administrator.

Run as Administrator will be disabled for Advertised Shortcut and Internet Shortcut.

General

Use a shortcut’s General settings to specify details such as the feature that contains the shortcut.

General Settings

Setting

Description

Feature

This setting indicates the feature or features with which the shortcut is associated.

Comments

Enter comments for this shortcut. Comments are saved in the project file for your reference and are not displayed to the end user.

See Also