Shortcuts |
|
|
|
Shortcuts |
|
|
Shortcuts |
|
|
|
Shortcuts |
|
|
|
|
||
MSI Factory
Create a shortcut to this file on the user's Desktop.
Be prudent in your use of this option. It is generally not considered good etiquette to litter the user's desktop with shortcuts. At most, limit yourself to making a shortcut for only your main program.
Create a shortcut to this file in the Start menu > Programs folder. The actual name and location of the folder is determined by the value on the Folders dialog, which by default is "[ProgramMenuFolder]My Product". The name of the product may also have been initially set on the Information screen of the Project Wizard.
Note: Whether these shortcuts are installed to the per-user or all-users desktop is determined at install time by the value of the MSI ALLUSERS property. You can give the user the choice by including the "UserProfileDlg" dialog in your dialog sequence.
Create a shortcut to this file using a folder ID from the Folder Manager. Click the "Browse" button to open the Folders dialog to select a folder ID.
The description that will accompany the shortcut(s). By default, if the file does not contain any version resources, the filename will be used as the description. If the file does contain version resources, its description will be extracted from that information. You may want to change this to something more meaningful and descriptive.
Note: Properties inserted into the description will not be expanded at runtime. Build variables, however, can be used.
The command line arguments that you want passed to the file when the user uses the shortcut to launch the file.
The working directory for the shortcut. Select the "Folder ID" option to indicate that the value is a folder identifier from your project. Select the "Property" option to indicate that the value you are entering is a property that holds the folder location rather than a folder reference or path.
The run mode for the file. Choose from:
The file will be run with its window at normal size.
The file will be run with its window minimized.
The file will be run with its window maximized.
An optional string to display in the "comment" section of the shortcut. This parameter is only supported on Windows 2000 and later. On operating systems that do not support the information, it will be ignored.
The shortcut key combination you want to assign to the shortcut. To assign a shortcut, place your cursor in this field and press the keyboard keys you want to use as the shortcut key. If this field contains the string "None", no shortcut key will be assigned.
If checked, the shortcut will be advertised. An advertised shortcut will cause the entire feature it is in to be re-installed and re-verified every time that the shortcut is used. Although this can sometimes be desirable, you should generally use it with caution. It is generally considered "safer" not to advertise shortcuts. Make sure that you understand Windows Installer advertising before using this feature (see More Information links below.)
If checked, you can specify an external icon file that will be used for the shortcut. If unchecked, the icon in the file's resources, or if the file does not have any icon resources, the default Windows icon for its file type will be used. You must specify a custom icon if Advertise is checked.
The path to the icon file that will be used to represent this shortcut on the user's system. The file must be a valid Windows icon (.ico) file. You can click the Browse button to select a standard icon (.ico) file from your system. You can use a relative path in this field. The path will be relative to the location where the project (.msifact) file is saved. This file will be brought along with the installer in the Icon table. Note that although you can technically specify an executable or DLL file containing icons, this is not recommended because an entire copy of the file will be brought along with the installer - even if it is already in your project's file list. This will bloat the size of your installer unnecessarily.
The index of the icon you want to use for this shortcut. If there is only one icon in the file, or if you want to use the first icon found, enter 0.
Note: If you require more flexibility with your shortcuts than allowed by the Shortcuts tab, you can configure other shortcuts from the Shortcuts dialog (Actions > Shortcuts on the menu.)
MSDN Online: Advertisement
MSDN Online: ALLUSERS Property
MSDN Online: Shortcut Table
MSDN Online: Installation-On-Demand
WiX Help File: Shortcut Element
Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us