The Install Settings Dialog
This dialog is opened when you click the Edit Install Settings property or when you select the File / Build / Install Program command. It allows you to setup and build an install program for your application.
This dialog box contains a toolbar and a tabbed window :
Toolbar
The toolbar contains the following buttons:
Import Texts : allows you to import the texts of your install program from an external file. Several template files in different languages are provided with Multimedia Fusion 2 Developer.
Export Texts : allows you to export the texts of your install program to an external file.
Test Install Wizard : allows you to view the appearance of your install program. Note: this doesn't run actually your install program, this only runs the interface.
Build Install Program : click this button to build the EXE file of your install program.
Install Options
The options that allow you to customize your install program are in the following tabs:
Options
This tab contains the main options:
Product Title : enter in this box the name of your product. By default it's set to the name of the application. Each occurrence of the #title macro in the texts and shortcut names in your installer will be replaced with this name.
Default install directory : enter here the install directory that will appear by default in the Select Install Directory screen of the install wizard. You can use macros to insert system directories, these macros will be replaced by the pathname of the system directories on the user's machine. Click the "button" to see all the available macros. You can also use the #Title macro to insert the name of your product in the install path.
Font : allows you to change the font used by the texts in the screens of your install program.
Files
This tab contains the list of files to install:
List : lists all the files installed b y your install program. This includes the main file of your application, all the external files that are directly accessed by their pathname (i.e. not by expressions in the event editor), and all the files you have manually added.
Add : click this button to add files to the installer. These files must be either in the directory of the application, or in sub-directories.
Remove : click this option to remove files from the list. You can remove files only if you have added them with the Add button.
File Options :
This group contains several tabs that allow you to fine tune the installation of each file. To change the option of one or more files, select it/them in the list.
Start Menu:
Allows you to add a shortcut to the Programs folder of the Windows Start menu.
Folder : enter here the name of the folder for the shortcut.
Shortcut Name : enter here the name of the shortcut.
Command Line options : enter here any option to be added to the shortcut's command line.
Icon file : if you want to associate a specific icon to your file, enter here the filename of a .ico file. This .ico file must be installed with your application, i.e. you must add it with the Add button if it's not already in the Files list.
Shortcut:
Allows you to install a shortcut to the desktop.
Desktop shortcut name : enter here the name of the shortcut.
Command Line options : enter here any option to be added to the shortcut's command line.
Icon file : if you want to associate a specific icon to your file, enter here the filename of a .ico file. This .ico file must be installed with your application, i.e. you must add it with the Add button if it's not already in the Files list.
View / Run :
Allows you to view or run a file after it has been installed. If a View option is selected, the program associated with the file's extension will be launched. If a Run option is selected, the file must be an executable file.
View : select at which time you want to display the file.
Run : select at which time you want to run the file.
Command Line options : enter here any option to be added to the command line.
Wait for end : available only when you run an executable file. Select this option to make the installer wait for the program to ends.
View or run after reboot : if this option is selected and the installer needs to restart the machine, the file will be displayed or run after the reboot.
Windows:
Install directory : if you want to install a file to a specific directory, select here this directory. "Destination directory" is the install directory chosen by the user. "Other" lets you enter a specific path in the edit box below (click the ">" button to insert macros).
Important if you choose another destination than "Destination directory", "My Documents directory" or "Application Data directory", the sub-folder of the source file is ignored and will not appear in the destination filename. If you want to install a file to a sub-directory of one of the system directories above, choose "Other" and enter the macro for the system directory followed by the name of the sub-directory, e.g. #Windows#\MyCompany.
Install as current screen saver : installs a .SCR file as current screen saver and displays the Screen properties. Note: you should install your .SCR files to the System directory, so that they do not disappear from the list if the user selects another screen saver. If you install your .SCR file to the System directory, you do not need to install the other files to the System directory too, you can install them to another directory, for example #Program Files#\YourScreenSaver: the install program will write the install directory in the .SCR file so that the screen saver can access the external files the application uses.
Register OCX control, DLL, .REG file : if this option is selected, the install program will either call the DllRegisterServer function of the DLL file, or call Regedit to register the .REG file.
Increment DLL usage count : Adds 1 to the dll usage counter of this DLL. This counter is used to know how many applications use the DLL. When the uninstaller uninstalls the DLL, it decrements the counter and will uninstall the DLL if the counter is equal to 0, i.e. if the DLL is no longer used by any application.
Misc:
Do not install this file : allows you not to install a specific file. Also gives you the possibility to install a shortcut to a file without having to install the actual file. Especially useful for installations from a CDROM.
Do not uninstall this file : specifies a file that does not have to be uninstalled by the uninstall program.
Do not install, but create directory : Gives you the possibility to create an empty directory. The file is not included in the install program.
Do not install if ... A file with the same name is already installed : The file won't be installed if a file with the same name is already installed.
Do not install if ... A higher version of the file is already installed : The install program will compare the internal File Version number of the file already installed with the one of the file to install and won't install it if the installed version has a higher number. Use this option for shared system files you install to the System directory.
Wizard Texts
This tab contains the texts of your install program:
Pages : lists all the screens of your installer. Select a page in the list to see its texts below.
Texts : lists all the texts for the page selected in the list above. When you select a text, a quick description is displayed below the text list. Click a selected text to edit it. Some long texts like the info text in the Information and License pages can be double-clicked, this opens a multi-line edit box where you can edit your text more comfortably. If you have modified a text and would like to revert it to the original text, right-click it and select "Default" in the popup menu. Note: the Information and License pages are not displayed if their main text is empty.
Preview : click this button to see the selected page as it would be displayed in the install wizard.
Uninstaller
This tab contains the settings of the uninstaller for your install program:
Options
Uninstaller filename : enter here the filename of the uninstaller. Remove it if you do not want an uninstaller for your product.
Folder : enter here the name of the folder for the shortcut that will be installed in the Programs folder of the Windows Start menu for your uninstaller. Remove it if you do not want install a shortcut for your uninstaller.
Shortcut Name : enter here the name of the shortcut that will be installed in the Programs folder of the Windows Start menu for your uninstaller. Remove it if you do not want install a shortcut for your uninstaller.
Texts : allows you to customize all the texts of your uninstaller. Click a selected text to edit it.
Registry : allows you to remove keys from the registry when the user uninstalls your product. Enter full key names. For example:
HKEY_CURRENT_USER\Software\YourCompany\YourProduct .
Build
This tab is displayed when you build your install program. It displays the progression, the list of the compressed files and a quick summary at the end.