ScriptMaker Tutorial

The [Icons] Page

Select the file you want by clicking it in the file list. If the file is an executable file, ScriptMaker will display it's icon in the icon box to the right of the file list. If the file contains no icons, ScriptMaker's action differs depending upon the version of Inno Setup in use. For versions earlier than 1.12, if the file is a .txt file, the Notepad icon will be displayed; if the file is a help file, the Help icon will be displayed; if the file is none of these types then the icons contained in the system file moricon.dll will be shown. With Inno Setup 1.12 onwards, if no icons exist in the chosen file, ScriptMaker simply checks the Use App Paths Registry entry checkbox (see below).

When more than one icon exists for the chosen file, a small scrollbar appears at the bottom of the icon box, and you can scroll through the icons to select the one you want. You can also double-click the icon box to get a wider view of all the icons in the selected file.

It is also possible to associate an icon from another file, even one which is not included in your installation set - either type the path and filename of the icon file in the Icon File field, or select the file using the "browse" button on the right of the field. If the file from which the icon comes is not part of your installation, ScriptMaker will offer to extract the icon and include it in your list of files. You should accept this if you cannot be sure that the file will already be installed on the user's machine, or if you cannot be sure of it's location on the user's machine.

In 32-bit installations the Use App Paths Registry entry checkbox allows you to specify just a filename (i.e. no path) in the Filename parameter. Inno Setup will then retrieve the pathname from the App Paths registry key and add it to the filename automatically.

When you have selected an icon for a file ScriptMaker will make default entries in the next five fields.

The Displayed Name field should contain the wording you want to see on the user's Start Menu for this file, and also the location on the Start Menu. In the illustration ScriptMaker will appear in the menu group which was set in the Default Group Name field on the [Setup] page (denoted by the Directory Constant {group}). If you want to add parameters to the command when the program represented by the icon is executed, enter the parameters in the Command Line Parameters field. These parameters will be added to the name of the program (as specified in the Command Line Filename field) when the file is launched. The entry in the Command Line Filename field will normally include a Directory Constant.

The Working Directory field should contain the directory in which the application is started. This can also include Directory Constants.

Finally we come to the Comment (Win 2000) field. This lets you customize the Comment (or "description") field of the shortcut, which determines the popup hint for it in Windows 2000. Windows 95/98 and NT 4 ignore the comment.

Options

Once all the necessary fields have been completed, click the Add button to add the entry to the Icons Grid. As with all the grids in ScriptMaker, you can delete an item from the grid by first selecting it and then clicking the Delete button. An item can be edited by double-clicking it remove it from the grid and place it in the fields at the top.

Example

The Displayed Name field should now contain the entry {group}\intro.mid. You will probably want to change this to something more meaningful, such as {group}\Introductory Song. The Command Line Filename field will also need to be changed so that your midi player is launched rather than the song itself (at present the field will say {app}\intro.mid), so change it to {app}\MyPlayer.exe or whatever your player is called. In the Command Line Parameters field put the command which is to be passed to your program (e.g. /play intro.mid). The Working directory field can be left as {app}.