Copyright: Copyright © 1996 Stirling Technologies, Inc.


Advanced Options
.

	Advanced Options
.

The Advanced InstallShield Objects Options dialog allows you to see which files Express added to your setup and view the details (date, size, and version, if applicable) of the files.

You can reveal or hide the files in the System Files - WinSysDir group by clicking on the +/- icon next to the group name.  To view the details of a particular file, click on the appropriate filename in the list box.

The Advanced InstallShield Objects Options dialog is not drag-and-drop enabled.  You cannot use it to add or delete files, only to view file information.

If you need to add additional InstallShield Objects, click on the [image] tab.  If you need to delete files from the group, you can do so in the Groups and Files dialog.


Advanced Settings
.

	Advanced Settings
.

The Advanced icon settings dialog allows you to select an alternate working directory, choose an image from a separate resource, specify a shortcut key, or place an icon directly on the Start Programs menu (Windows 95 only).

You cannot use any of the advanced options for an icon until you add the icon in the General icon settings dialog.

•	To set a working directory:  Highlight the icon for which you want to set a new working directory.  The current working directory will be displayed in the Working Directory combo box.  Specify a new directory using one of the Express directory specifiers.

When you have selected the desired directory, click on the Modify Info push button.

•	To select an icon image from a resource file:  The resource (such as an .ICO or .DLL file) containing the icon must have already been copied to one of your program groups.  Highlight the icon for which you want to set a new image.  Click on the browse (...) button next to the Icon field to open the Setup Files Browser window.  Select the desired resource file and click OK.

When you return to the Advanced window, the resource file will be listed in the Icon field.  Click on the Modify Info push button to apply the new icon.

•	To specify a short cut key:  Highlight the icon for which you want to set a short cut.  Click on the Short Cut Key field so that the cursor appears in it.  This is a special edit field.  On your keyboard, press the key combination as you would if you were using the short cut.  The Short Cut Key field will reflect your typing.  For example, if you press the Control key, Alt key, and the letter A, the edit field will display Ctrl + Alt + A.  If you make a mistake, hit the Delete key and start over.

When you have entered the desired combination, click on the Modify Info push button.

•	To place the icon on the Start Programs menu in Windows 95:  Highlight the icon which you want to place directly on the Start Programs menu.  Select the Place icon on Start Menu check box.  Click on the Modify Info push button.

Please note that Windows 95 Setup Guidelines recommend that you do this if you only have one icon, in order to make your application as easy as possible to access.  However, you should not add more than one icon to the Start Programs menu, as that clutters up the menu.

After you have finished making you modifications, click on OK to accept them, Cancel to reject them, or the [image]. tab to add or delete new icons.

Note  You cannot add or delete icons from the Advanced icon settings dialog.  You must use the General icon settings dialog.


Application Information (App Info)
.

	Application Information (App Info)
.

The Application Information dialog collects information which Express uses internally.  You must enter information or leave the default settings in the Application Name, Version, and Company fields in order to comply with Windows 95 Setup Guidelines.  If you erase any of these fields, Express will not be able to make the automatic registry entries necessary to meet Windows 95 specifications, including the uninstallation entry.

This dialog contains five edit fields:

•	Application Name:  Enter the full name of your application (80 characters max.).  The default setting for this field will be the project name you entered in the New Project dialog box.

•	Application Executable:  Click on the browse (...) push button next to this field to launch the Open dialog.  From this dialog, locate and select your primary executable.  When you click on the Open push button to close this dialog, the filename will be displayed in the grayed edit field, along with the [Program Files] directory specifier.

Express will automatically add the specified executable to the Program Files group in the Groups and Files dialog and create an icon for the executable in the General Icon Settings dialog as long as there are not already entries in either dialog.  If you have made an entry in either dialog, Express will not make these automatic modifications.

•	Version:  If you specify an executable which contains a version resource in the Application Executable, Express will enter the version number in this field.  Otherwise, the default setting for this field is 1.0.  You can also enter or modify the version number of your application.  You can format your version number however you like (the field will accept up to 40 characters).

•	Company:  Enter the name of your company (80 characters max.).  The default setting for this field will be the company name you entered when you first installed Express.

•	Default Destination Directory: In Express, you can designate the Program Files directory on the target system using the <ProgramFilesDir> directory specifier.  You can also use the <CommonFilesDir> specifier to indicate the Common Files directory on the target system (e.g. C:\PROGRAM FILES\COMMON FILES).

Note  Do not use the <INSTALLDIR> specifier to indicate the default destination directory.  The Disk Builder will generate a warning message if you do.  Express uses the Choose Destination Location user dialog to get the value of <INSTALLDIR> from the user.  Using <INSTALLDIR> in your setting will create an unusable default for your user.

If you do not specify a directory, Express will set the default to C:\PROGRAM FILES\<Company>\<Application>.  The names of the <Company> and <Application> directories will be determined by the information you entered in Company and Application Name fields of this dialog.

After you have entered the above information, you can click OK to accept the data, Cancel to reject it, or either of the two other tabs, [image] or [image], to enter additional information in the Set the Visual Design window.

Click here to see technical details about how your responses to the Application Information dialog are used by Express.  (You do not need to know this information to use Express.)


BDE (Borland Database Engine) Settings
.

	BDE (Borland Database Engine) Settings
.

The BDE/IDAPI Settings dialog allows you to create BDE aliases, as well as specify any additional parameters for your alias.  It also allows you to save the alias settings (.CFG file) so that they can be used by both 16- and 32-bit applications.

When you select the BDE/IDAPI check box in the InstallShield Objects window, Express will automatically launch the Settings dialogs.

BDE Installation Type

Use the BDE Installation Type dialog box to specify whether you want to install all or part of BDE in your setup.

If you select the Full BDE Installation radio button, the check boxes in the BDE Driver Types and Query Engine Types windows will be inactive, and you can continue to the next dialog.

Note  If you only want to install part of BDE, please read the Partial BDE Installation documentation for important information regarding your setup.

When you are finished, click Next to continue on to the alias settings (Step 1-4) or Cancel to reject your settings.

Step 1

To create a BDE alias, click on the New push button to launch the BDE Alias Name dialog.  In this dialog, enter the desired alias in the Alias Name field.  Click on OK to enter the alias, or Cancel to reject it.

The aliases you have specified will be listed in the BDE Aliases window.  To delete an alias, highlight its name in the window and click on the Delete push button.  When you are finished adding aliases, click Next to continue on to Step 2, Back to return to the BDE Installation Type dialog, or Cancel to reject your settings.

Step 2

This step allows you to save the .CFG file containing your alias settings so that both 16- and 32-bit applications can use them.  If you, select the check box, Express will automatically make the necessary modifications on the target system.

Click on Next to go to step 3, Back to return to the first step, or Cancel to reject your settings.

Step 3

To define a parameter for your BDE/IDAPI alias:

In the Alias Name combo box, use the drop-down list to select the alias for which you want to define a parameter.

Type the path in the Path edit field.  Use Express directory specifiers in this field to indicate the target directory location of your database file.

Select the database driver from the drop-down list in the Type combo box.

Note  You must enter the target path and driver type for your database file or your alias will not get created on the target system.

Type in any additional parameters in the window at the bottom.  You may use Express directory specifiers in this window as well.

When you have defined all of the parameter for each alias, click on Next to go to step 4, Back to return to step 2, or Cancel to reject your settings.

Step 4

Step 4 informs you that the settings you have specified have been initialized, and Express will configure the target system.  Click on Back if you want to go back and review or change your settings, or click on Finish to accept them.


Before You Begin
.

	Before You Begin
.

Return Your Registration Form

Before you do anything else, please fill out the registration form that comes with Express.  Not only does this register you for technical support, it also lets us know where to send any future builds or vital information as it becomes available.

When you register, you will be helping both yourself and InstallShield Corporation.

Organize and Prepare Your Files

Even though InstallShield Express is the most convenient installation toolkit yet created, using it does require some preparation.  In order to plan a successful setup, you need to consider the structure of your application files.

Because every setup has a unique set of files and varying installation requirements, Express includes a flexible, yet simple, organizing system.  Your files are copied into groups, which are included in components.  These components can be used to create multiple setup types.

All of the files in a group will be copied to the same directory.  Copying your files into the group will be quick and easy if you already you have them in separate directories which represent your groups.

You need to consider whether you want to include a custom setup option.  If there are any files which are not needed to run the application, such as samples or templates, you might consider placing them in separate components, which the user could elect not to install.

If you're unfamiliar with groups, components, and setup types, or if you would like more information about using them in Express, refer to the Groups, Components, and Setup Types topic.

Note  Windows 95 Setup Guidelines recommend that you do not modify the CONFIG.SYS system file.  Design your application to load its drivers when the application is launched.

Familiarize Yourself with Express

Once you have organized your application files, you need to consider whether your application requires that any special processing be done during the setup.  If you are unsure about these potential requirements, or you don't know what features InstallShield Express offers for your specific needs, refer to the Deciding Which Setup Options To Use topic.


Before You Contact Us...
.

	Before You Contact Us...
.

InstallShield Corporation is committed to providing the best possible technical support for Express and all of our products.  In order to get you the fastest, most complete, and most accurate support, please follow the procedures listed below.

Register Your Software

You must be a registered user to receive technical support.  If you have not already sent the registration form included with Express, please fill out and fax it to InstallShield Corporation at (847) 240-9120.

Remember that sending in your registration form also lets us know where to send you maintenance releases and other important information as it becomes available.

Necessary Information for Technical Support

The technical support department at InstallShield likes to provide detailed and accurate answers to all of your questions.  In order to do so, our representatives will need the following information:

•	Your full name and the name of the registered user, if different.

•	Your street address, phone and fax number, and email address.

•	The serial number of your copy of Express.

•	The full, six-digit Express version number.  This can be found in the About box, which you can quickly open by clicking on the About push button: .

•	The system information of the computer you are using, including the make and model of the machine and video driver, the operating system, the amount of memory and system resources, any relevant devices or peripherals.

•	A detailed description of the problem.  Describe any error messages exactly as they appear.  Please list also the steps and conditions which led to the problem.

The Best Ways To Contact Technical Support

Because of the amount of information our technical support department needs, and because finding an answer may require some research on our part, calling us is often the least effective method of getting technical support.

We recommend the following methods as the quickest and best ways to get the answers you need:

1.	Express Documentation

Before you spend the time gathering information, contacting InstallShield, and waiting for a response, make sure that the answer to your question is not in Express documentation.  Take advantage of the search features in our help files.  If you click on the Search push button in help and go to the Find tab, you can create a full text index of help and search for individual words or phrases.

Check the Readme file for any last-minute information, known problems, and FAQs

2.	InstallShield website (http://www.installshield.com)

The InstallShield website is constantly being updated with news and notes about all of our products.  Of particular assistance will be the Express Knowledge Base, which contains the latest news and information regard this product, including FAQs and troubleshooting information.

3.	Email

Once you have determined that the documentation does not contain the answer you need, the best way to contact the technical support department is through email.  Our address is express@installshield.com.

The Readme file contains an email form which you can fill out and send to us.  You can use a non-standard form, just make sure that you include all of the necessary information listed above.

4.	Fax

Faxing is the next most efficient means of contacting us.  Our technical support fax number is (847) 240-9138.

5.	CompuServe

If you subscribe to CompuServe, our CIS ID is 102737,577.


Billboards
.

	Billboards
.

Selecting the Billboards user interface component allows you to display a billboard during your application installation.  You can use a bitmap (.BMP) or Windows metafile (.WMF) as your billboard.

In order to use the billboard in Express, you must name your billboard file SETUP1.BMP or SETUP1.WMF.  Specify the directory of your file on the Billboard Settings tab either by using the browse (...) push button to search for the path, or by typing the path in the edit field.

Note  InstallShield Express Delphi Edition supports only 16-color bitmaps.

InstallShield Express will automatically display the billboard during the file transfer process.

Express includes a bitmap billboard file (SETUP1.BMP) in the REDIST subdirectory of your main Express directory.  This directory is also set as the default path for the billboard.  You can quickly customize this bitmap and use it without having to specify a new directory.


Choose Destination Location
.

	Choose Destination Location
.

The Choose Destination Location user dialog allows the user to select the directory in which he wants to install your application.  The directory and path selected by the user will be used to replace the <INSTALLDIR> directory specifier in any of the Express dialogs in which you have used it.

You can specify a default directory in the Choose Destination Location Settings tab by typing the path in the edit field.  Microsoft's Windows 95 Setup Guidelines recommend that the destination directory for your application be a subdirectory of the Program Files directory, and that you use a long filename to help create a unique name for it.

In Express, you can designate the Program Files directory on the target system using the <ProgramFilesDir> directory specifier.  You can also use the <CommonFilesDir> specifier to indicate the Common Files directory on the target system (e.g. C:\PROGRAM FILES\COMMON FILES).

Note  Do not use the <INSTALLDIR> specifier to indicate the default destination directory.  The Disk Builder will generate a warning message if you do.  Express uses the Choose Destination Location user dialog to get the value of <INSTALLDIR> from the user.  Using <INSTALLDIR> in your setting will create an unusable default for your user.

If you do not specify a directory, Express will set the default to C:\PROGRAM FILES\<Company>\<Application>.  The names of the <Company> and <Application> directories will be determined by the information you entered in the Application Information Express dialog.


Components
.

	Components
.

The Components dialog allows you to create and modify your components, which are the building blocks of a custom setup, and write a description of each to help the user.

Note  If you have chosen not to offer a custom setup, you do not need to use this dialog.  All of your file groups are automatically added to the Application Files component.  There is no need to add components, since they are only used to create custom or compact setup types.

If you are not familiar with the concept of components, or you would like to learn how to take greater advantage of them in your setup, refer to Groups, Components, and Setup Types in the Planning Your Setup section.

If you are offering a custom setup type, the default components are Application Files, Help and Tutorial Files, and Sample Files.  Also by default, the Program Files, Help Files, and Sample Files groups are assigned to the Application Files, Help and Tutorial Files, and Sample Files components, respectively.

Use the following methods to create and modify your components:

•	To add a component:  Click the Add Component push button.  Type the name you want to give the component in the Component Name edit field.  Enter a description for your reference in the Description field.  Click the OK button to enter your change.

•	To delete a component:  Click on the name of the component you want to delete to highlight it.  Then press the Delete key on your keyboard.

•	To modify a component:  Highlight the name of the component you want to modify.  Click the Modify Component push button.  Type the new component name or description in the appropriate field.  Click the OK button to enter your change.

Once you have set your components, use the following methods to assign file groups to them:

•	To add a group to a component:  Highlight the group you want to add and the component you want to add it to.  Click on the Add to Application Component push button.

A +/- indicator will be displayed to the left of a component which contains any group(s).  You can click on this indicator to hide or reveal the group(s) copied to the particular component.

•	To delete a group from a component:  In the Application Components window, click on the + indicator, if necessary, to reveal the group you want to delete.  Click on the group name to highlight it.  Press the Delete key on your keyboard.

Note  If you are offering a custom setup and you have added file groups, you must assign each group to a component or the group will not be installed.  Modifications to groups, however, are dynamic -- you do not have to reassign a modified group to a component.

When you are finished with the Components dialog, you will likely need to tab to the [image] dialog.


Contacting InstallShield Corporation
.

	Contacting InstallShield Corporation
.

InstallShield Corporation Addresses and Phone Numbers

Internet	Sales and Marketing: Technical Support:	info@installshield.com express@installshield.com
World Wide Web		http://www.installshield.com
Phone	Corporate Office: Sales:	(847) 240-9111 (800) 374-4353
Fax	Corporate Office: Technical Support:	(847) 240-9120 (847) 240-9138
Mail		900 National Parkway Suite 125 Schaumburg, IL  60173-9946 USA
CompuServe	CIS ID:	102737,577


Contents
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Planning Your Setup

Using Setup Options

Building and Testing Your Setup

Distributing Your Application

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Contents - BTYS
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Planning Your Setup

Using Setup Options

Building and Testing Your Setup

Run Disk Builder

Test the Installation

Distributing Your Application

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Contents - DYA
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Planning Your Setup

Using Setup Options

Building and Testing Your Setup

Distributing Your Application

Create Distribution Media

How Your User Executes the Setup

unInstallShield

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Contents - GAH
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Planning Your Setup

Using Setup Options

Building and Testing Your Setup

Distributing Your Application

Getting Additional Help

Before You Contact Us...

Contacting InstallShield Corporation

Other Suggested Resources

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>

Part No. 231-20004


Contents - GS
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Before You Begin

Opening a New or Existing Setup Project

Express Directory Specifiers

Planning Your Setup

Using Setup Options

Building and Testing Your Setup

Distributing Your Application

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Contents - Intro
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Welcome

The Express User Interface

How To Use the Express Help

A Note From the Editor

Getting Started

Planning Your Setup

Using Setup Options

Building and Testing Your Setup

Distributing Your Application

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Contents - PYS
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Planning Your Setup

Groups, Components, and Setup Types

Deciding Which Setup Options To Use

Windows 95 Setup Guidelines

Using Setup Options

Building and Testing Your Setup

Distributing Your Application

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Contents - USO
.

	Contents
.

Welcome to the InstallShield Express Delphi Edition Help Files.  Please select one of the following options:

Introduction

Getting Started

Planning Your Setup

Using Setup Options

Set the Visual Design

Specify Components and Files

Select User Interface Components

Select InstallShield Objects for Delphi

Make Registry Changes

Specify Folders and Icons

Building and Testing Your Setup

Distributing Your Application

Getting Additional Help

Visit the InstallShield Web Site.  URL: <http://www.installshield.com>


Create Distribution Media
.

	Create Distribution Media
.

Once you are satisfied with your setup, you are ready to copy it to the distribution media.  Express provides a simple means of doing so.

Click on the Copy to Floppy push button in the Express main window.  In the Copy To Floppy dialog, your selection in the Drive box determines the destination of your installation files:

•	If you select A:, Express will copy your setup directly to a disk in the A: drive.

Note  The entries in this combo-box are dynamic and reflect the disk drives on your system.  For example, if your machine has two disk drives, A: and B:, both will be offered as options in the Drive box, along with the two path options.

•	If you select Path, the Path edit field will be activated, and you can then enter the path where you want to copy your setup, allowing you to place the files directly onto a network or hard disk location.  You can use standard DOS paths or UNC paths in the edit field.

After you have selected your destination, you can click on the Copy All Disk Images push button or highlight an individual image in the Disk Images window and click on the Copy Selected Disk Image push button.  If you are copying all disk images to diskettes, Express will prompt you for each disk.

These options allow you to copy all or part of your setup to either disks or a network location with just a few mouse clicks.


Custom Setup
.

	Custom Setup
.

The Custom Setup user dialog will be displayed only if the user selects a Custom setup type in the Setup Type user dialog.  The Custom Setup ("Choose Options") dialog allows the user to select the components of your application which he or she wishes to install.

This dialog also allows the user to select a destination directory using the browse (...) push button.  (The user's selection on this dialog will override a selection made on the Choose Destination Location or Setup Type dialogs, if applicable, and will reset the value of <INSTALLDIR>.)

When you select or deselect the Custom Setup user dialog, you will automatically select or deselect the Setup Type user dialog, and vice-versa.

You must specify the files and groups which make up the components in the Specify Components and Files Express dialog.

The Custom Setup dialog has no settings.

For more information about groups and components, refer to the Groups, Components, and Setup Types section of Planning Your Setup.


Deciding Which Setup Options To Use
.

	Deciding Which Setup Options To Use
.

Because InstallShield Express is the easiest setup program yet designed, you do not need to even open most of the dialogs.  You can just accept the default settings and sit back while Express does the work for you.

But we also recognize that many applications have special setup needs, so Express offers you the setup options you need (in the most user-friendly forms possible, of course).

Determining which setup options to take advantage of is as easy as answering some basic questions:

•	Is your application name different than the project name?  Do you want to specify your main application executable to take advantage of the per-application paths feature?  Do you want to specify a version number other than 1.0?  Do you want to use a company name other than the one you entered as user information for Express?  If you answered yes to any of the above questions, you will need to make changes in the Application Information dialog.

•	Do you want to include a custom bitmap in your main setup window?  Do you want to specify a title or background color for your setup?  If you answered yes to either of these questions, you will need to make changes in the Main Window dialog.

•	What information do you want to give the user during the setup?  What information do you need to get back from him?  Based on your answers, specify the appropriate user dialogs in the Select User Interface Components dialog.

•	Do you need to include Delphi 3.0 redistributable files with your application?  Express has an automated process for including these files in the Select InstallShield Objects for Delphi dialog.

•	Are you offering custom and compact setup types?  These options require careful planning and the deliberate use of the Groups and Files, Components, and Setup Types dialogs.  If you are not familiar with these concepts or how they are implemented in a setup, refer to Groups, Components, and Setup Types.

•	Do you need to make changes to the registry?  Entries which would previously have been made in the WIN.INI file should, according to the Windows 95 Setup Guidelines, be made to the registry.  These can be specified in the Registry - Keys and Registry - Values dialogs.

Note that, in order to comply with Windows 95 Setup Guidelines, you must specify an uninstallation key for all entries into the registry.  Unless you instruct it not to, InstallShield Express will automatically make the necessary entries to allow unInstallShield to uninstall the application, but you must set the uninstall keys for any other entries you make.

•	What icons do you want to include with your application?  Any icons are specified in the General and Advanced icon settings dialogs.  Please note that Windows 95 Setup Guidelines suggest keeping icons to a minimum.

Once you have decided which options you want to use, follow the simple instructions for each dialog to create a setup that fits your needs.


Disk Builder Error Messages
.

	Disk Builder Error Messages
.

Warning Messages

Warning messages are displayed in the Feedback window of the Disk Builder.  The warning will not cause the Disk Builder to stop executing, but the condition that caused the warning may cause serious problems in your setup.

Many warning messages concern the misuse of Express directory specifiers.  A warning will occur if an unknown group or variable name is referenced.

Note  Group name directory specifiers are delimited by [ ] and the other directory specifiers by < >.  The group names and specifiers are case- and white space-sensitive.

Warning Number	Description	Possible Solution
102	Unknown specifier '%s'* used for value in registry key %s.	Go to the Registry - Keys dialog.  Find and highlight the registry key specified.  Click on the Registry - Values tab.  Fix or delete the unknown specifier.
103	Unknown specifier '%s' used as command for icon '%s'.	Go to the General Icon Settings dialog.  Highlight the icon specified.  Fix or delete the unknown specifier in the Run Command edit field.
104	Unknown specifier '%s' used as parameter for icon '%s'.	Go to the General Icon Settings dialog.  Highlight the icon specified.  Fix or delete the unknown specifier in the Run Command Parameters edit field.
105	Unknown specifier '%s' used as working directory for icon '%s'.	Go to the Advanced Icon Settings dialog.  Highlight the icon specified.  Fix or delete the unknown specifier in the  Working Directory edit field.
106	Unknown specifier '%s' used as icon file name for icon '%s'.	Go to the Advanced Icon Settings dialog.  Highlight the icon specified.  Fix or delete the unknown specifier in the  Icon edit field.
110	Unknown specifier '%s' used as run command in Setup Complete dialog.	Go to the Setup Complete user dialog in the Select User Interface Components section and click on the Settings tab.  Fix or delete the unknown specifier in the Run Command edit field.
111	Unknown specifier '%s' used as run command parameter in Setup Complete dialog.	Go to the Setup Complete user dialog in the Select User Interface Components section and click on the Settings tab.  Fix or delete the unknown specifier in the Run Command Parameters edit field.
112	Unknown specifier '%s' used as Readme file in Setup Complete dialog.	Go to the Setup Complete user dialog in the Select User Interface Components section and click on the Settings tab.  Fix or delete the unknown specifier in the Readme  File edit field.
113	Unknown specifier '%s' used as application EXE name in App Info section.	Go to the Application Information dialog.  Fix or delete the unknown specifier in the Application Executable edit field.
120	The group %s is not assigned to any component.	Go to the Components dialog and assign the specified group to the appropriate component.
121	The component %s is not assigned to any setup type.	Go to the Setup Types dialog and add the specified component to the appropriate setup type(s).
130	No bitmap specified for Welcome Bitmap dialog.	Go to the Welcome Bitmap settings tab and specify the appropriate bitmap file.
131	No file specified for Software License Agreement dialog.	Go to the Software License Agreement settings tab and specify the file containing your license agreement.
132	No file specified for Readme Information dialog.	Go to the Readme Information settings tab and specify your Readme file..
133	No default directory specified for Choose Destination Location dialog.	Go to the Choose Destination Location settings tab and specify a default directory.
134	No default folder name given for Select Program Folder dialog.	Go to the Select Program Folder settings tab and specify a default folder name.
135	No directory given for billboard file(s).	Go to the Billboards settings tab and specify the directory which contains your billboard file(s).
140	No icons created as part of your setup.	Go to the General Icon Settings dialog.  Specify the icon(s) you want to include in your program folder.
141	The icon description '%s' is too long for Program Manager.**  Program Manager limits icon descriptions to 40 characters.	Go to the General Icon Settings dialog.  Edit your entry in the Description field until it contains 40 or fewer characters.
142	The program folder name '%s' is too long for Program Manager.  Program Manager limits program folder names to 29 characters.	Go to the Select Program Folder Settings tab and specify a default folder name that is 29 characters or shorter.
143	The <INSTALLDIR> directory specifier should not be used in the Choose Destination Location user dialog.	Go to the Choose Destination Location Settings tab and specify a default target directory that does not include the <INSTALLDIR> directory specifier.
144	No components were added to the '%s' setup type.	Go to the Setup Types dialog and add the appropriate component(s) to the specified setup type.
145	No groups were added to the '%s' component.	Go to the Components dialog and either add the appropriate groups to the specified component, or delete the component.
146	No files were added to the '%s' group.	Go to the Groups and Files dialog and either add the appropriate files to the specified group, or delete the group.
* The %s format specifier is replaced by the filename in the warning or error message.

** Program Manager applies not only to Windows 3.x, but also to Windows NT and, in some cases, Windows 95.

Error Messages

An error message from the Disk Builder will cause Express to stop executing.  Error messages are generated by problems which prevent one of the InstallShield Express programs from carrying out its task.  Except for error number 150, errors are displayed in a secondary dialog box, as shown below:

A typical error message generated by the Express Disk Builder.

Error Number	Description	Possible Solutions
-1	Unknown error
-2	Unable to open input file.  Command parameters=%s*
-3	Unable to open output file.  Command parameters=%s
-4	Unable to write to file.  Command parameters=%s
-5	Input file not compressed with InstallShield Compressor
-6	Memory allocation error
-7	Header information of compressed file is incorrect
-9	Source and target directories conflict
-16	Library compacting error
-38	Out of disk space	You must free disk space on the drive containing your setup project before running the Disk Builder again.
-43	Compression error during read/write of non-compression data
-46	Target file is read-only
150	Build canceled due to missing files.	See Missing Files for more details.


Express Directory Specifiers
.

	Express Directory Specifiers
.

One of the biggest considerations in creating a setup is accounting for the differences between the various target systems of your users.  You have no way of knowing where a particular user will want to install your application, nor even where the main Windows and System directories are on that system.

For that reason, InstallShield Express includes a set of directory specifiers which are replaced by information about the user's system during the installation.  They are used whenever you need to express the location of a file after it has been copied to the target system.

<INSTALLDIR>  This specifier is replaced with the main installation directory selected by the user during the setup process.  The user selects this directory in the Choose Destination Location dialog (although, in an installation with multiple setup types, he may override his earlier selection in either the Setup Type or Custom Setup user dialog).

<WINDIR>  This specifier is replaced with the main Windows directory on the target system (e.g. C:\WINDOWS).

<WINSYSDIR>  This specifier is replaced with the Windows System directory on the target system (e.g. C:\WINDOWS\SYSTEM).  If the target machine is running Windows NT, this specifier will indicate the SYSTEM32 directory.  If you need to include 16-bit DLLs with your 32-bit application, use <WINSYS16DIR> instead.

<WINDISK>  This specifier is replaced with the drive letter of the disk containing the Windows directory (e.g. C:).

<WINSYSDISK>  This specifier is replaced with the drive letter of the disk containing the Windows System directory (e.g. C:).

<WINSYS16DIR>  On a Windows NT target system, this specifier is replaced with the 16-bit System directory.  On a Windows 95 machine, this specifier is exactly like <WINSYSDIR>.

<ProgramFilesDir>  This specifier is replaced with the Program Files directory on the target system (e.g. C:\PROGRAM FILES).  In Windows 95, the Program Files directory location is stored in the registry under the "ProgramFilesDir" value name.  In Windows NT, Express appends the Program Files subdirectory to <WINDISK>.

<CommonFilesDir>  This specifier is replaced with the Common Files directory on the target system (e.g. C:\PROGRAM FILES\COMMON FILES).  In Windows 95, the Common Files directory location is stored in the registry under the "CommonFilesDir" value name.  In Windows NT, Express appends the Common Files subdirectory to <WINDISK>\Program Files.

[group name]  A bracketed group name (e.g. [Program Files]) can also be used as a specifier.  This specifier is replaced by the directory into which the particular group is copied.

You can indicate a subdirectory of any of these specifiers by modifying them as you would any standard path.  To specify the HELP subdirectory of your main directory, you would enter "<INSTALLDIR>\HELP".  Or, to specify the TEMPLATES subdirectory of the directory containing the Support Files group, you would enter "[Support Files]\TEMPLATES".

The Help for each dialog will indicate whether Express directory specifiers can be used in any of the edit fields.

Express automatically uses some of these specifiers in certain locations, such as the Application Executable field in the Application Information dialog, and the Run Command field in the General Icon Settings dialog.


Express User Interface
.

	The Express User Interface
.

InstallShield Express has a simple, yet flexible, interface which allows you to navigate the program features using familiar controls.

Title Bar:  Displays your project name next to the full Express name.  You can access the System menu by either left-clicking on the small icon at top left, or right-clicking anywhere on the bar.

Menu Bar:  Contains four drop-down menus:

•	File -- contains New, Open, Close, Save, Save As, and Exit options, as well as the most recently used files and shortcut keys.

•	View -- allows you to display or hide the toolbar and status bar.

•	Checklist -- provides an alternative method for accessing Setup Checklist items using a mouse or your keyboard.

•	Help -- gives you quick access to the Quick Tour, Help Index, Readme, Online Registration for InstallShield Express, or About box.

Toolbar:  Contains nine push buttons which access some of the most common control dialogs:

  New -- Opens the New Project dialog box.

  Open -- Opens the Open dialog box.

  Save -- Automatically saves your project under its current name and location.

  Build -- Launches the Disk Builder dialog.

  Test Run -- Executes a test run.

  Copy to Floppy -- Launches the Copy to Floppy dialog.

  Explorer -- Launches Windows Explorer.

  About -- Opens the About InstallShield Express message box.

  Help -- Accesses context-sensitive help.  When you click on this push button, the question mark icon will appear to be "attached" to your arrow icon.  Point the arrow at the checklist item for which you want help, and single-click to open Express Help on that particular topic.

Checkmarks:  These also serve as reminders.  A checkmark will appear next to each dialog in which you have made and accepted settings.  You do not need to have all, or any particular number, of the dialogs checked in order to create your setup.

Pointer:  The hand icon will point to the uppermost dialog in the Setup Checklist for which you have not yet accepted settings.  It serves no purpose other than as a reminder.

Push Buttons:  You can instantly access any of the Express dialogs by clicking on the appropriate push button or the name of the dialog.

Dog-ear:  On lower resolution monitors, click the dog-ear to reveal the rest of the Setup Checklist.  On all resolutions, clicking the dog-ear reveals contact information for InstallShield Express.

Status Bar:  Displays basic information about the control which the arrow is pointing at.


Features
.

	Features
.

The Features dialog contains the Automatic Uninstaller check box.

We strongly recommend that you leave  the Automatic Uninstaller check box in its default position, selected.  When this box is checked, Express will automatically include unInstallShield, the InstallShield uninstallation program, with your application.

If your user chooses to uninstall your application, unInstallShield can automatically remove your application files, icons, folders, directories, and registry entries.

Refer to the unInstallShield topic in these files for more information.

Note  unInstallShield will automatically remove those registry entries which are, by default, created by Express.  It will not remove any additional registry keys you may have specified in the Make Registry Changes dialog.  You will need to add an uninstall key for any entries you have made.  Refer to the Registry - Keys dialog for more information.

After you have made your selection, you can click OK to accept it, Cancel to reject it, or either of the two other tabs, [image] or [image], to enter additional information in the Set the Visual Design window.


General Options
.

	General Options
.

InstallShield Objects allow you to add Delphi 3.0 functionality to your application.  In the InstallShield Objects for Delphi window, select the controls which your application requires.  Express will automatically create the group(s) and add the files necessary for the InstallShield Object(s) you select.

You should not change the default directories for any of the automatically generated groups.

Note  If you are not using any of these options, do not select any of the InstallShield Objects.  They will add unnecessary files to your setup.

Click here for help on the BDE (Borland Database Engine) Settings, which allow you to specify a full or partial BDE install and create BDE aliases.

Click here for help on the SQL Links Settings, which allow you to specify the driver(s) you want to install.

Click here for help on the ReportSmith Runtime Report Viewer Settings, which allow you to install ReportSmith connections.

If you want to see which files are added or view details of any of the files selected in the InstallShield Objects dialog, click on the [image] tab.


General Settings
.

	General Settings
.

The General icon settings dialog allows you to specify the icons you want to place in your application's folder (Windows 95) or group (Windows NT).  On Windows 95 systems, the folder will be placed on the Start Programs menu.  You can place an individual icon on the Start Programs menu using the Advanced icon settings tab.

•	To add an icon:  Click on the browse (...) button next to the Run Command field.  The Setup Files Browser window will open, displaying the files which you have previously copied to your program groups in the Groups and Files dialog.  Select the program file to which you want to assign an icon, and click OK to close the window.

When you return to the General dialog, the installation path of the file (e.g. [Program Files]\YOURAPP.EXE) will be displayed in the Run Command field.

You can specify a command parameter by either clicking on the browse button next to the box and selecting an installation path from the Setup Files Browser window, or by typing it in the Run Command Parameter combo box.  You must specify the location of any file in this field using an Express directory specifier.

Enter the name which you want to appear under the icon in the Description field.  The default entry in this field will be the program filename.

When you have made your specifications, click on the Add Icon push button.  InstallShield Express uses the following steps to determine the icon image:

1.	Express first looks for an icon resource within the program file.  If more than one is present, Express will use the first resource it encounters.

2.	If the file does not include an icon resource, Express checks the registry to see if the file extension is associated with an icon.  If so, Express will select that image.

3.	If the file does not include an icon resource, and the registry does not associate an icon with the extension, a message box will be displayed informing you that Express will use a default icon.  If you want to use an outside resource for your icon image, such as an .ICO or .DLL file, you can do so in the Advanced icon settings dialog.

Note  If you are using only one icon, Windows 95 Setup Guidelines recommend that you add the icon directly to the Start Programs menu.  You can do this in the Advanced icon settings dialog.

•	To delete an icon:  Click on the icon image to highlight it.  Press the Delete key on your keyboard.

•	To modify an icon:  Click on the icon image to highlight it.  Make the desired changes in the appropriate field or box.  Click on the Modify Icon push button.

When you have finished making all of your general icon selections, you can click on OK to accept the specifications, Cancel to reject them, or the [image] tab to take advantage of additional options.


Groups and Files
.

	Groups and Files
.

The Groups and Files dialog allows you to organize your application files into groups, which are used to determine the location of the files on the target system.

If you are not familiar with the concept of file groups, or you would like to learn how to take greater advantage of them in your setup, refer to Groups, Components, and Setup Types.

If you are offering a custom setup type, the default groups are Program Files, Help Files, and Sample Files.  Use the following methods to create new and modify existing file groups:

•	To add a group:  Click the Add Group push button.  Type the name you want to give the group in the Group Name edit field.  Specify the directory in which you want to install the group in the Destination Directory field by selecting one of the Express directory specifiers in the drop-down list or typing the desired path.  Click the OK button to enter your change.

Your entry in the Destination Directory field is very important, as it will determine the relative location where your files will be copied.  Your main installation directory will be the <INSTALLDIR> directory.  This specifier will be replaced by the target directory selected by the user during the setup process.

Files which must be located in the main Windows directory should be placed in groups with <WINDIR> as the specified destination directory.  Files which must be located in the system directory should be placed in groups with <WINSYSDIR> as the specified destination directory.

Note  Any files in groups which you are copying to the Windows (<WINDIR>) or System (<WINSYSDIR>) will not be copied if there is a more recent version of the file already in the directory.  This feature prevents you from writing over an updated version of a shared file.

You can specify destination directories relative to the locations represented by these specifiers by modifying the particular specifier in the Destination Directory field.  For example, to place the Help Files group in the HELP subdirectory of the main application directory, enter "<INSTALLDIR>\HELP" as the group's destination directory.

You can also locate groups relative to other group names using the [ ] delimiters around the group name in the Destination Directory field.  To place the Help Support group in the SUPPORT subdirectory of the directory which will contain the Help Files group, enter "[Help Files]\SUPPORT" as the group's destination directory.

You can even include multiple subdirectory levels (within the field limit of 80 characters) and Express will create all of the subdirectories for you.

Note  The folder icons in the File Groups window will not reflect the relative location of the group you specified in the Destination Directory field.  All folder icons are displayed as if they were on the same level.

•	To delete a group:  Click on the name of the group you want to delete to highlight it.  Then press the Delete key on your keyboard.  A Delete Confirmation message box will be displayed.  Click OK to confirm your deletion.

•	To modify a group:  Highlight the name of the group you want to modify.  Click the Modify Group push button.Type the new group name or destination directory in the appropriate field.  Click OK to confirm your modification.

Do not change the name of the groups automatically generated by Express, or Express will be unable to create the proper settings on the target system.

Note  If you chose not to offer a custom setup type when you created your new project, the only default group will be Program Files.  If you still are not offering a custom setup, and if all of your application files can go in the same directory, simply drag and drop them onto the Program Files group.  Even if you add groups, you do not have to set or modify any components -- when you do not use multiple setup types, all groups are automatically added to the single necessary component.

Once you have arranged your groups, use the following methods to place files in them:

•	To add files:  Click on the Launch Explorer push button to run or activate Windows Explorer (you can also use File Manager for this task).  In Explorer, highlight the files you want to copy.  Drag and drop them onto the Groups and Files dialog.  The files will be copied onto the group your pointer is closest to when you drop them.

A +/- indicator will be displayed to the left of a group which contains any file(s).  You can click on this indicator to hide or reveal the file(s) copied to the particular group.

Once a file has been added to a group, you cannot simply reassign it to another group.  If you need to place a file (or files) into a different group, delete it from its current group listing and then add it to the other group.

•	To delete files:  Click on the + indicator, if necessary, to reveal the file you want to delete.  Click on the filename to highlight the file.  Press the Delete key on your keyboard.

When you add files to a group, InstallShield Express copies the full path and filename of each file.  Therefore, do not change the path or filenames of any files after dragging and dropping them onto the groups, or else the Disk Builder will be unable to locate your files when it compiles your setup.

Because the lengths of paths can prevent you from viewing the filenames in the File Groups window, you can deselect the Display full pathname for files check box to view the filenames only.

You can quickly view the date, size, and version number of a file by highlighting the file and clicking on the File Details push button.

If you are using multiple setup types, when you are finished with the Groups and Files dialog, you will need to tab to the [image] dialog.


Groups, Components, and Setup Types
.

	Groups, Components, and Setup Types
.

Groups, components, and setup types provide the framework for copying your files.  In InstallShield Express, you select the files to be copied by dragging and dropping them into groups.  You add these groups to components, which represent logical elements of your application.  Using components, you can offer multiple setup types to your user.

The figure below graphically represents the relationship between these concepts:

You have probably already encountered multiple setup types while installing software.  Setup types allow the user to select from among several installation "packages."

You do not have to include multiple setup types in your installation.  Even if you chose the option to offer them when you first opened your project, you can go to the Select User Interface Components dialog and deselect either the Setup Type or Custom Setup user dialog.  This will dynamically modify the Setup Types tab on the Specify Components and Files dialog to display only one setup type: Complete.

If, however, you do choose to include multiple setup types, Express supports these three:

Typical:  Usually a complete setup, including all components.

Compact:  Usually consists only of those components necessary to run the application.

Custom:  Allows the user to select which components will be installed.

As the descriptions above suggest, components are the building blocks of setup types.  Components, which are made up of file groups, represent different parts of the application, such as Help and Readme files, templates and examples, tutorials, and the main application itself.

If you are not offering multiple setup types, you don't even need to worry about components.  Express adds all file groups to a single component.  That component is automatically included in the Complete setup type.

If you are offering multiple setup types, you will specify which components are included with each setup type in the Setup Types Express dialog.

You create your components by adding groups to each component in the Components dialog.

Groups are similar to components, in that they are collections of related files.  However, in Express, files and destinations are assigned directly to groups, then the groups are assigned to components.

Basically, groups allow you increased flexibility.  By specifying different destination directories in the Groups and Files dialog, you can create components which include files to be placed in more than one directory, rather than having to specify one directory for the entire component.

Again, if you are not offering multiple setup types, you won't need to spend much time assigning groups.  Since you have one setup type and need only one component, the only purpose for creating separate groups for your application files would be to assign different relative destination directories.  Drag and drop all files which will go into the same directory into the same group.

Planning your files groups and components becomes even more critical when you are offering setup type options.  The following sample plan exemplifies some of the issues you will need to address.

Sample Group and Component Plan

Note  This sample may be much more complex than your application structure.  The number and configuration of groups and components were chosen in order to illustrate several concepts in one example.  Don't be fooled into thinking you have to make your setup unnecessarily complex.  The simpler your installation structure is, the easier it is to plan.

Let's assume you have an application called MyApp, and you have decided (after some gentle urging from your supervisor) to use multiple setup types.

You initially divide your application into five components: Help Docs, Examples, Data Files, Utility Programs, and Application Files.  All five components will be included in both the Typical and Custom setup types.  All except for Examples will be included in the Compact setup type.

You plan to install all of the files from the Utility Programs and Application Files components in the <INSTALLDIR> directory.  You wish to place Examples in <INSTALLDIR>\EXAMPLES, and Data Files in <INSTALLDIR>\DATA.  Since the files in each of these components all go in the same directory, you have created and assigned only one group for each.

You have been instructed to place each piece of the documentation in its own directory, so you have created three groups for the Help Docs components: Readme Files (to be placed in <INSTALLDIR>\README), Help Files (<INSTALLDIR>\HELP) and Tutorial (<INSTALLDIR>\HELP\TUTORIAL).

Thus, your initial plan could be represented by the following chart:

Groups	Components	Included in  Compact setup?

As you are preparing and testing your setup, you realize that some of the data files are shared DLLs which really ought to be installed in the <WINSYSDIR> directory.  So you delete the Data Files group and create two new groups, Text Files and DLLs.  You specify <INSTALLDIR>\DATA for the Text Files group and <WINSYSDIR> for the DLLs group, and assign both to the Data Files component.

Your supervisor then informs you that the extensive tutorial which he demanded of you is not an absolutely necessary piece of documentation, so it should not be included in the Compact setup type.  Rather than create a whole new component, you decide to delete the Tutorial group from Help Docs and add it to the Examples component, which you rename Support Files.

Shortly thereafter, Ted from marketing complains that his beta version of your product isn't working properly.  When you go to look at his system, you realize that he chose a custom setup and did not install the Utility Programs component.  You decide that, in order to try to prevent anyone else from making this mistake, you will delete the Utility Programs component and add the Utility Programs group to the Application Files component.

Ted then informs you that you have to include a marketing survey, and your supervisor backs him up, although he does not insist that your survey be required for installation.  So you add the Survey group and component and assign the component to the Typical and Custom, but not Compact, setup types.

Now your updated plan chart looks like the following:

Groups	Components	Included in  Compact setup?

Fortunately, InstallShield Express allows you to make all of these changes without having to rewrite sections of code.  A few clicks on the right dialog boxes, a couple of drags and drops, and you're ready to go again.

Of course, all of this planning is worthless if you don't get the files into the right groups.  When you are testing, experiment by selecting different components for a custom setup.  Make sure that everything you want copied is being copied (and is being copied to the right directory).

Although Express will allow up to 100 components, and up to 100 groups per component, try to use only as many groups and components as you need to accomplish what you want.

And remember that careful planning of your groups, components, and setup types can save you hours of headaches later when you don't understand why files aren't where they're supposed to be.


How To Use the Express Help
.

	How To Use the Express Help
.

The Express Help is a standard Windows help file.  If you are not familiar with the Winhelp format, here are a few tips:

•	You can access context-sensitive help at any time in one of three different ways:

1.	Click on the help button [image].  A question mark icon will be "attached" to your arrow icon.  Then click on the desired topic.

2.	Click on the Help push button in any dialog.

3.	Press the <F1> key at any time.

•	Once in Help, use the Contents push button to return to the main contents screen.

•	You can click on the Search push button to browse through the list of topics or create a full-text search.  When you click on Search, you will open the Index tab, which allows you to browse the topic titles or type the first few letters of the word you're looking for.  You can also click on the Find tab and follow the instructions to create a full-text index, which will allow you to search for specific words or phrases within all Help topics.

•	To return to a topic you have previously viewed, click on the Back push button until you reach the desired topic, or open the Options menu and select Display History Window... to view the twenty most recent topics you have visited.  Double-click on a topic name in the history window to return to that topic.

•	You can set a bookmark for the current topic by selecting Define from the Bookmark menu.  You can use the topic name to define your bookmark, or you can type your own entry in the Bookmark name edit field.

•	Print the current topic by clicking on the Print push button, or by selecting Print Topic... from the File menu.

For more information about Windows help files, refer to the "How To Use Help" topic in Windows help.


How Your User Executes the Setup
.

	How Your User Executes the Setup
.

Launching an InstallShield setup is a simple process.  Depending on the user's platform, you can instruct them to execute your installation in one of the following ways.

On Windows 95 systems, the user should always install software using Add/Remove Programs, which is located in the Control Panel.

If your product is designed for novice users, you might want to tell them that they can find Control Panel on the Start Settings menu.  Once the user launches Add/Remove Programs, all he or she has to do is load your disk or CD-ROM and click on the Install push button.  Windows 95 will automatically locate the setup and prompt the user.

On Windows NT systems, your user can launch your setup using a DOS prompt or File Manager.  From a DOS prompt, the user can go to the drive containing your distribution disk and type "Setup".  In File Manager, the user can click on the icon of the drive containing the distribution disk, then double-click on the SETUP.EXE filename.

After installing your application, your user will be able to uninstall it using Add/Remove Programs (Windows 95) or the Uninstall icon (Windows NT).  Refer to the unInstallShield topic for more information.


Keys
.

	Registry - Keys
.

The Registry - Keys dialog allows you to add keys to the registry.  This dialog is dynamically linked with the Registry - Values tab, which lets you add or modify the values of the highlighted key in the Registry - Keys dialog box.

You cannot add to or modify any of the six root keys.  Each key you create must therefore be a subkey of an existing key.

•	To add a key:  Click on the existing key below which you want to create your new key.  Click on the Add Key push button.  The Registry New Key dialog will be displayed.  Enter the name you want to give the key in the New Key field.  Click OK.

You can enter more than one level of subkeys at once using a backslash to separate them, as shown below:

Software\Company\MyApp\3.0\Help Files

When a key has one or more subkeys, a +/- indicator is displayed next to the folder icon.  You can click on this indicator to hide or reveal the subkeys.

•	To delete a key you have entered:  Highlight it in the Registry Keys window and press the Delete key on your keyboard.  Note that when you delete a key which has subkeys, all the subkeys are deleted as well.

•	To modify a key you have entered:  Highlight it in the Registry Keys window and click on the Modify Key push button.  The Registry Modify Key dialog will be displayed.   Retype the name in the New Key field and click OK.

The full path and name of the highlighted key is always displayed in the Full Key Name static text field, truncated at the right.  You can click the Registry Editor push button to launch your registry editor.

Once you have added a key, you can set the value(s) of the key by highlighting it and clicking on the [image] tab.  When you are finished with the registry dialogs, click OK to accept your entries or Cancel to reject them.

Click here to view the registry keys automatically entered by Express.  (You do not need to know this information to use Express.)

The following topic areas offer more detailed information on specific registry issues:

Uninstall Keys

Setting the Path Using the App Paths Key

Using the Registry Instead of WIN.INI


Main Window
.

	Main Window
.

The Main Window dialog allows you to create a distinctive appearance for your setup with minimal effort.  The dialog box is broken down into two group boxes and one combo box:

•	Main Title:  Select either the Bitmap or Text radio button, depending on whether or not you have a bitmap which you want to use as the main title displayed on the background of your installation.

If you select the Text radio button, click on the edit field beneath the radio buttons and type the title text exactly as you want it to appear (80 characters max.).  The title will be displayed across the background, starting at top left.

If you want to use a bitmap as your title, select the Bitmap radio button.  You can then either click on the browse (...) button to locate the bitmap file, or you can type the fully qualified path and filename in the edit field.  The bitmap will appear at top left.

If you do not want to display a title at top left, clear the edit field.

Note  InstallShield Express Delphi Edition supports only 16-color bitmaps.

•	Logo Bitmap:  Use this group box if you have a bitmap (other than a title bitmap) which you want to display in the installation.

To use this box to display a bitmap, click on the browse (...) button to select a bitmap file, or type the path and name of the file in the Bitmap edit field.

Click on the down arrow button in the Position combo box to select a location for your logo bitmap.  The options in this combo box are Bottom Left, Bottom Right, Centered, Top Left, and Top Right.

Note  If you select Top Left for your logo bitmap, and you also entered text or a bitmap in the Main Title group box, the logo bitmap will be displayed behind the main title text or bitmap.

•	Background Color:  Click on the down arrow push button to open the drop-down list which contains the different colors you can select for the background of your setup.  Your choices include blue, green, magenta, red, and yellow, all of which can be either dithered or solid.

After you have entered the above information, you can click OK to accept the data, Cancel to reject it, or either of the two other tabs, [image] or [image], to enter additional information in the Set the Visual Design window.


Make Registry Changes
.

	Make Registry Changes
.

The Make Registry Changes window has two tabs, each of which is accessed directly using its respective push button, one for making changes in the registry keys, another for adding or modifying registry key values:

Keys

Values


Missing Files
.

	Missing Files
.

When Express is unable to locate a file in the path specified, a dialog box will give you the following options: launching the Open dialog, which you can use to locate the file, deleting the file from your setup, or canceling the disk build.

If your file is not in the same location where it was when you copied it to its group, use the Open dialog to locate it.  When you find the file, select it and click on the Open push button to continue the disk build.

If you are unsure whether the file is necessary, click on the Cancel push button.  The Disk Builder will terminate, and you can make the necessary changes to your setup.

Note  If you have selected ReportSmith in the InstallShield Objects for Delphi dialog, Express may automatically add files which were not installed on your system to your setup.  Please see the note in ReportSmith


Note From the Editor
.

	A Note From the Editor
.

InstallShield Corporation is dedicated to producing world-class documentation that fits your needs.

If you have any comments or criticisms about any aspect of the Express documentation, please contact us at:

doc@installshield.com


Opening a New or Existing Setup Project
.

	Opening a New or Existing Setup Project
.

When you first start InstallShield Express, a welcome message box will be displayed, offering you the following options: Open an existing Setup Project, Open your last Setup Project, or Create a new Setup Project.  This dialog will be displayed every time you start Express unless you select the Don't display this screen again check box.

Select the appropriate radio button and click OK.  You can also click on the Quick Tour push button for a 15-minute quick tour of InstallShield Express.

New Setup Projects

If you are already working in Express, you can create a new setup project by clicking on the New push button on the toolbar [image], by selecting New from the File menu, or by pressing <Ctrl + N>.  Any of these methods will open the New Project dialog.

Use the Directory and Drive combo boxes to select the directory in which you want to place your setup project (.IWZ) file.  If you want Express to create a subdirectory for your setup, enter its name in the New Subdirectory field.  Express will automatically create the subdirectory under the specified path and place your project file in it.

Type the name of your application in the Project Name edit field.

If you know that you want to offer multiple setup types, select the Include a custom setup type option check box.  If you select this check box and later change your mind, you can still remove the custom and compact setup types options in the Setup Type or Custom Setup user dialogs.  Likewise, even if you do not select these options at first, you can add them later.

Opening an Existing Setup Project

If you select the Open your last Setup Project radio button from the welcome message box, Express will open the setup project file which you modified most recently.  To open a different project, select Open an existing Setup Project.

From within Express, you can click on the Open push button on the toolbar [image], select Open from the File menu, or press the <Ctrl + O> keys.

All of the above methods will launch the Open dialog, allowing you to open the project file you want to work on.


Other Suggested Resources
.

	Other Suggested Resources
.

If you are looking for more advanced setup software, a toolkit that gives you the power and complete flexibility to create your professional installation, we recommend InstallShield3, the World Leader in Installation Software.  Contact InstallShield Corporation sales at (800) 374-4353.

For more information regarding Windows help, we recommend that you search the main Windows Help.


Partial BDE Installation
.

	Partial BDE Installation
.

We recommended that you include a full BDE installation with any deployed Delphi application.  However, it is possible, in some cases, to install a partial set of BDE files.  A partial BDE installation must include the complete Core subset (see below).  You may then add or omit the query and database driver subsets as you prefer.

Note  When a user runs a Delphi application that included only a partial BDE installation, he cannot concurrently run another BDE-dependent application.  This is the primary limitation incurred by using a partial install of BDE.

Core subset (minimum required to support BDE)

Whether you choose a Full or Partial BDE installation, these Core files will be installed.  These files are required by all BDE-dependent applications:

IDAPI32.DLL	Core

IDR20009.DLL	 	Resource

BLW32.DLL	International

USA.BLL	Language Driver

EUROPE.BLL	Language Driver

OTHER.BLL	 	Language Driver

CHARSET.BLL	 	Language Driver

CEEUROPE.BLL

BDECFG32.EXE	BDE Configuration Utility

BDECFG32.HLP	 	BDE Configuration Utility Help

BDECFG32.CNT	   	BDE Configuration Utility Help Contents

Optional subsets

Your application will probably require at least one driver or the ODBC socket subset.  Each of the following subsets must be installed as a unit.  Do not delete any of the files in any subset from your installation.

Note  The complete subsets may be included in a partial BDE installation in any desired combination with the following important exception -- if you select either the Paradox or dBase driver option, you must also select either the SQL or QBE query engine.

The subsets consist of the following files:

Paradox driver subset:

IDPDX32.DLL	Paradox Driver

dBASE driver subset:

IDDBAS32.DLL	dBASE Driver

ASCII driver subset:

IDASCI32.DLL	 	ASCII Driver

ODBC socket subset:

IDODBC32.DLL	ODBC Driver

SQL Query subset:

IDSQL32.DLL	SQL Query

IDBAT32.DLL	Batch

IDPDX32.DLL	Paradox Driver

QBE Query subset:

IDQBE32.DLL	QBE Query

IDBAT32.DLL	Batch

IDPDX32.DLL	Paradox Driver


Progress Indicator
.

	Progress Indicator
.

The Progress Indicator gives the user a graphical representation of the file-transfer process.  The progress bar gradually increments to depict the percentage of the file transfer process which has been completed, while the text field above the bar displays the names of the files as they are copied.

There are no settings for the Progress Indicator.


Readme Information
.

	Readme Information
.

The Readme Information user dialog allows you to display a Readme text file to the user before the setup begins collecting information.

Note  The contents of the file will not be automatically formatted to fit the width of the multi-line edit field in which the Readme Information dialog displays the text.  If you do not want the user to have to use the left and right scroll arrows to read the text, you must format your text file using hard returns at the end of each line to be displayed.

Specify the text file in the Readme Information Settings tab either by using the browse (...) push button to search for the file on your source system, or by typing the fully qualified path and filename in the edit field.

Note  The Readme Information preview is a pre-canned sample.  The previewed image will not change to reflect your specified file.


Registration Form
Register your InstallShield Express product today!

Simply complete and return this file to become a registered InstallShield Express user to take immediate advantage of:

1.  Free 30 Days of Technical Support.  It's easy to get the answers to your InstallShield Express questions.  As a registered user, you can access InstallShield Express technical support any time you need it.  Please include your name, company, phone, fax, serial and version numbers with each technical support request.

Fax:	847-240-9138

Email:	express@installshield.com

CompuServe:	102737,577

2.  More InstallShield Express information.  By registering now, you will have free access to comprehensive InstallShield Express information only available to registered users.

3.  Special offers and updates.  Registered InstallShield Express users enjoy special offers, periodic product maintenance releases and news about other exciting products.  Register now to take full advantage of InstallShield Express products and services.

InstallShield Express Delphi Custom Edition Registration

Name	___________________________________________

InstallShield User (if different than above)	___________________________________________

Title	___________________________________________

Company	___________________________________________

Dept.	___________________________________________

Address	___________________________________________

City	___________________________________________

Country	___________________________________________

State/Province	___________________________________________

Zip/Postal Code	___________________________________________

Phone	___________________________________________

Fax	___________________________________________

Email	___________________________________________

WWW	___________________________________________

Comments (Comments can also be emailed to wish@installshield.com)

____________________________________________________________________________________

____________________________________________________________________________________

Please tell us about your application(s).  With what application(s) do you use InstallShield Express?

__ Software Category  _______________________________________________________________

__ Application Name(s)  ______________________________________________________________

Please send your completed registration from to InstallShield Corporation by fax (847-240-9138), email (express@installshield.com), or CompuServe (102737,577)


Registry Key Automatic Entries
.

	Registry Key Automatic Entries
.

InstallShield Express automatically makes the necessary registry entries to enable uninstallation, to enable the per-application paths feature, and to allow you to retrieve the user information.

Uninstallation registry entries

Express creates the registry keys and values necessary to run unInstallShield on your user's system.  The entries are stored under the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Current Version\Uninstall\<AppName>

The key name <AppName> is determined by your entry in the Application Name field of the  Application Information dialog.

Under this key, Express will enter two value pairs.  "DisplayName" will contain the information you entered in the Application Name field of the Application information dialog.  "UninstallString" will contain the appropriate launch command for UNINST.EXE, unInstallShield's executable file.

Windows will use the "DisplayName" data as the name of your application in Add/Remove Programs.  If the user selects to uninstall your application, Windows will use the "UninstallString" information to launch unInstallShield.

App Paths registry entry

In Windows 95, the per-application paths (App Paths) key in the registry has eliminated the necessity of modifying the path in AUTOEXEC.BAT for your application.  If you specifyExpress automatically makes the App Paths entry for you.

The per-application paths information is stored under the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\<YOURAPP.EXE>

The key name <YOURAPP.EXE> is determined by the executable filename you entered in the Application Information dialog.  The "[Default]" value of this key will contain the fully qualified path of your primary executable (YOURAPP.EXE).

Note  You must specify a file in the Application Executable field of the Application information dialog box.  If you do not, Express will not make the App Paths entry for you.

Once this information is registered, the shell will provide the application path to ShellExecuteEx when the application is executed.  Additionally, this information will allow the user to start your application by selecting Run from the Start menu and typing the filename of the executable.

If you need to modify the path for any other files in your application, create the [Path] value under this key and set it equal to the desired path.

User Information registry entry

Express places the information obtained from the User Information user dialog under the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\<Company>\<AppName>\<Version>

The key names <Company>, <AppName>, and <Version> are determined by the information you entered in the Company, Application Name, and Version fields of the Application Information dialog box.

The values collected entered by the user in response to the User Information dialog will be stored under "Name," "Company," and "Serial" (if applicable).


Registry Topics - Replacing WIN.INI Changes
According to the Windows 95 Setup Guidelines, your application should no longer record information in the WIN.INI file.  Instead, store the necessary information in the registry under the HKEY_CURRENT_USER\Software key.

Because you will need to set this new key as an uninstallation key in order to comply with Windows 95 guidelines, we recommend that you create the subkey \<Company>\<Application>.  By using your company and application names, you will create unique keys, so that the user could uninstall them without deleting information from any other application.


Registry Topics - Setting the Path
According to the Windows 95 Setup Guidelines, new applications should not modify the AUTOEXEC.BAT file.  To replace the path on previous systems, the registry includes a per-applications path key.

Express automatically enters the path of your primary executable under the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\<YOURAPP.EXE>

The key name <YOURAPP.EXE> is determined by the executable filename you entered in the Application Information dialog.  The [Default] value name of this key will contain the fully qualified path of your primary executable (YOURAPP.EXE).

Note  You must specify a file in the Application Executable field of the Application information dialog box.  If you do not, Express will not make the App Paths entry for you.

If you need to set an additional path, use the Registry - Values dialog to create the [Paths] value name under the same key, and add the desired path as the data for the value pair.


Registry Topics - Uninstall Keys
If you do not add any additional registry keys, you do not have to select an uninstall key for your application in order to support unInstallShield.  Unless you specifically deselect the check box in the Features dialog, InstallShield Express automatically makes the necessary uninstallation registry entries to satisfy Windows 95 Setup Guidelines.

However, in order to comply with the setup guidelines, you must uninstall all registry entries created by the application.  Therefore, if you have added keys to the registry, you must set an uninstall key for unInstallShield.

Select an uninstall key by highlighting the desired key and selecting the Uninstall Key check box.

BE VERY CAUTIOUS when selecting your uninstall key.  If you select a key which has existing entries on the target system, such as the HKEY_LOCAL_MACHINE\SOFTWARE key, and the user chooses to uninstall your application, all of the keys and values under that key, including those from other applications, will be deleted.


ReportSmith Runtime Report Viewer Settings
.

	ReportSmith Runtime Report Viewer Settings
.

The ReportSmith Runtime Report Viewer Settings Settings dialog allows you to install database connections, as well as specify any necessary parameters for your connections.

In order to use the ReportSmith object, you must also select the BDE (Borland Database Engine) object.

Note  If you select the ReportSmith object, Express will automatically add files to your setup which you may not have installed with Borland Delphi 3.0.  When you run the Disk Builder, Express may not be able to find some or all of the following files: RS_DBLIB.DLL, RS_GUP.DLL, RS_IDAPI.DLL, RS_ORA7.DLL, RS_ODBC.DLL, and RS_SYBAS.DLL.  If any of these files are not on your system and you are using the ReportSmith object, you will need to go back to the Groups and Files dialog when you have finished your object selections and delete the appropriate files from the ReportSmith Viewer Files group.

Step 1

The first ReportSmith settings dialog will display a checklist of the connections which exist on your system.  Check the boxes next to the connections that you want to include with your application.  When you have selected your connections, click Next to continue on to the next step, or Cancel to reject your settings.

Step 2

To define a parameter for your ReportSmith connection:

In the Database connection combo box, use the drop-down list to select the connection for which you want to define a parameter.

In the Database connection parameters window, define the path on the target system for each connection using Express directory specifiers and the keyword=path format.  For example, if the keyword for your database is DataFilePath and the file will be copied to the DATA subdirectory of your main installation directory, enter the following:

DataFilePath=<INSTALLDIR>\DATA

Note  You must enter the target path for your database file in the proper format or your connection will not get installed on the target system.

Type in any additional parameters in the same window, separated by carriage returns.

When you have defined all of the parameter for each alias, click on Next to go to step 3, Back to return to step 1, or Cancel to reject your settings.

Step 3

Step 3 informs you that the settings you have specified have been initialized, and Express will configure the target system.  Click on Back if you want to go back and review or change your settings, or click on Finish to accept them.


Run Disk Builder
.

	Run Disk Builder
.

After you have made your settings, the Disk Builder does all the rest of the work for you.  It creates a data file from your settings which will be passed to the InstallShield script, compresses your application and installation files, splits the compressed files, and places the split files into separate directories which correspond to your distribution disks.

To do all this, click on the Disk Builder push button on Express main window.  Once the Disk Builder dialog is open, select the distribution media format (CD-ROM, 2.88MB, 1.44MB, 1.2MB, or 720K) in the Disk Size drop-down box.  Then click the Build push button.

While the Disk Builder is running, the Build push button will be replaced by the Cancel push button, which you can click at any time to stop execution.

As the Disk Builder begins each task, it will display a message string in the Feedback window.  It will also display warning and error messages as necessary.  The progress bar at bottom right will indicate the status of the build.  The builder will display a message box letting you know when it is finished.

If the Disk Builder is unable to locate a file in the directory specified, a dialog box will give you the option of launching the Open dialog, which you can use to specify the location of the file.  If you are unable to find the file using the dialog, you will get an error message.  In this case, find the path specified for the file in the Groups and Files dialog.  You must then either place the file in the specified location and re-run the Disk Builder, or delete the file altogether from your setup.

When the Disk Builder completes successfully, click on the Close push button to exit the dialog.  You should do a Test Run to ensure that the setup does exactly what you want.  If it does, you are ready to create your distribution media.

When you use the Copy to Floppy feature, Express will automatically retrieve the necessary files and copy them to a disk or other distribution media.

Click here if you get an error or warning message from the Disk Builder.

Click here if you have missing files in your disk build.


SQL Links Settings
.

	SQL Links Settings
.

If you select the SQL Links object, Express will automatically launch the SQL Links Settings dialog.  All available drivers are, by default, selected.  If you do not want to include any of the drivers, uncheck the check boxes next to the drivers you do not want installed.

Express will add the necessary files and make the required registry changes to install the selected drivers.  Click on Finish to accept your settings, or Cancel to reject them.

Note  If you select the SQL Links object, you must select the BDE (Borland Database Engine) object as well.


Select InstallShield Objects for Delphi
.

	Select InstallShield Objects for Delphi
.

Note  If you are not using Delphi 3.0, you can still use Express to create your setup.  If you are using a different platform, do not save any settings from either of the Select InstallShield Objects for Delphi dialogs, because the filenames and paths copied by Express will reference files that do not exist on your system (files which are specific to Delphi 3.0).  If you do accidentally add these files, go to the Groups and Files dialog and delete them.

The Select InstallShield Objects for Delphi window has two tabs, each of which is accessed directly using its respective push button:

General Options

Advanced Options


Select Program Folder
.

	Select Program Folder
.

The Select Program Folder user dialog allows the user to choose the program folder (Windows 95) or group (Windows NT) in which your application icons will be placed.

Specify the default folder name by typing it into the edit field on the Select Program Folder Settings tab.  If you do not specify a folder name, Express will use your setup project name as the default folder name.


Select User Interface Components
.

	Select User Interface Components
.

The Select User Interface Components dialog consists of the Settings For list box, which contains check boxes for selecting and deselecting each of the user interface components in your setup, and a dynamic, tabbed dialog box which displays compressed previews of the user dialogs and allows you to modify the settings for some of them.

•	To select or deselect a user dialog, click on the check box next to the dialog name.  Note that if you deselect either Setup Type or Custom Setup, the other is automatically deselected.

•	Click on the Preview push button to see a full-size preview of the highlighted dialog.

•	To modify the settings for a particular user dialog, highlight the dialog and click on the Settings tab.

•	InstallShield Express includes the following user dialogs:

Welcome Bitmap

Welcome Message

Software License Agreement

Readme Information

User Information

Choose Destination Location

Setup Type

Custom Setup

Select Program Folder

Start Copying Files

Progress Indicator

Billboards

Setup Complete

When you have finished selecting your installation dialogs and modifying their settings, Click OK.


Set the Visual Design
.

	Set the Visual Design
.

The first three dialogs of InstallShield Express ask you to enter some basic application information, which is mostly used behind the scenes by Express, and the settings for the overall visual design of your installation.

The Set the Visual Design window has three tabs, each of which is accessed directly using its respective push button:

Application Information (App Info)

Main Window

Features


Setup Complete
.

	Setup Complete
.

The Setup Complete user dialog actually consists of two dialogs: a reboot computer dialog box and a launch application dialog box.  The preview shows only the reboot computer dialog.

Reboot computer

The reboot computer dialog informs the user that the installation is complete, and gives him the option to reboot his computer.  This is, of course, especially useful if your installation has made system changes (such as adding a VXD) that require a restart.

InstallShield will automatically display the reboot computer dialog if your setup encounters any locked or shared files.  You can also display the dialog for all installations by selecting the Always show reboot computer dialog check box in the Settings tab.

Launch application or Readme

The launch application dialog allows the user to run your application or view your Readme file by selecting a check box and clicking OK.  You can specify either or both options in the Launch application dialog window

To offer the launch application option, click on the browse (...) push button next to the Run Command field to open the Setup Files Browser dialog box.  Highlight your primary executable from among the files you have added to your groups in the Groups and Files dialog.  Click OK to accept your choice or Cancel to close the dialog.

Note  You must have either copied files into groups in the Groups and Files dialog or specified an application executable in the Application Information dialog in order to select a file from the Setup Files Browser.  If you want to offer the option of launching a Readme file, you must first copy the Readme file to a group, then return to the Setup Complete user dialog and select the file.

You can also specify your executable by typing the installation path and filename in the Run Command field.  Because the program will be launched after the installation, the path must be specified using one of the Express directory specifiers.

If you need to add a parameter to your launch command, specify it also by either selecting a file from the Setup Files Browser or typing your command line option(s) in the Run Command Parameters field.  You can use an Express directory specifier in this field also.

Likewise, if you want to allow the user to launch your Readme file from the Setup Complete dialog, make your file selection in the Readme File field using the Setup Files Browser feature or your trusty keyboard.  (As with the executable file above, use a group name or directory specifier for the path).

You can offer the option to launch both the application or Readme, either one separately, or neither.

Note  If you do not select an executable or Readme file in the Launch application dialog window, but the reboot computer Setup Complete user dialog is displayed, the launch application dialog will also be displayed, though without any options for the user.


Setup Files Browser
The Setup Files Browser dialog box displays the files already copied to your groups, and allows you to select one of the files, or drag-and-drop another desired file.  If you do not find the file you are looking for among those you have copied to your file groups, you can drag and drop the desired file from Windows Explorer or File Manager.

You can create UNC paths using the Setup Files Browser through Network Neighborhood.


Setup Type
.

	Setup Type
.

The Setup Type user dialog allows the user to select a Typical, Compact, or Custom installation.  You must create the components for each of these setup types in the Specify Components and Files Express dialog.

This dialog also allows the user to select a destination directory using the browse (...) push button.  (The user's selection on this dialog will override a selection made on the Choose Destination Location dialog, if applicable, and will reset the value of <INSTALLDIR>.)

This dialog must be selected if you are offering multiple setup types.  If you do not want to give the user these options, deselect the Setup Type user dialog.  When you select or deselect the Setup Type user dialog, you will automatically select or deselect the Custom Setup user dialog, and vice-versa.

The Setup Type user dialog has no settings.

For more information about setup types, refer to the Groups, Components, and Setup Types section of Planning Your Setup.


Setup Types
.

	Setup Types
.

The Setup Types dialog allows you to specify the components which will be included with your Custom, Typical and Compact setup types.  InstallShield Express only supports these three setup types.  You cannot change them or add additional setup types.

Note  If you have chosen not to allow custom setup types, you do not need to make any modifications in this dialog.  The Setup Types dialog will contain only one type, Complete, which will contain your component by default.

If you are not familiar with the concept of setup types, or you would like to learn how to take greater advantage of them in your setup, refer to Groups, Components, and Setup Types in the Planning Your Setup section.

Use the following methods to create and modify your setup types:

•	To add a component to a setup type:  Highlight the names of the component you want to add, and the setup type you want to add it to.  Click on the Add to Setup Type push button.

A +/- indicator will be displayed to the left of a setup type which contains any component(s).  You can click on this indicator to hide or reveal the component(s) copied to the particular setup type.

•	To delete a component from a setup type:  In the Setup Type window, click on the + indicator, if necessary, to reveal the component you want to delete.  Click on the component name to highlight it.  Press the Delete key on your keyboard.

Note  The Complete or Custom setup type will always, by default, contain all of your components, including new ones you create.  You can delete components from these setup types, but it is not recommended that you do so.


Software License Agreement
.

	Software License Agreement
.

The Software License Agreement user dialog allows you to display a text file containing a copy of your license agreement.

Specify your file on the Software License Agreement Settings tab either by using the browse (...) push button to search for the file on your source system, or by typing the fully qualified path and filename in the edit field.

Note  The Software License Agreement preview is a pre-canned sample.  The previewed image will not change to reflect your specified text file.


Specify Components and Files
.

	Specify Components and Files
.

The Specify Components and Files dialogs provide the means for you to organize your application files for the installation and create a flexible setup.  If you are not familiar with file groups, components, and setup types, or you would like to learn how to take greater advantage of them in your setup, refer to Groups, Components, and Setup Types in the Planning Your Setup section.

The Specify Components and Files window has three tabs, each of which is accessed directly using its respective push button:

Groups and Files

Components

Setup Types


Specify Folders and Icons
.

	Specify Folders and Icons
.

The Specify Folders and Icons window has two tabs, each of which is accessed directly using its respective push button:

General Settings

Advanced Settings


Start Copying Files
.

	Start Copying Files
.

The Start Copying Files user dialog displays the setup type, destination directory, and user information entered by the user.  It allows the user to double-check his entries and, if necessary, go back and modify one or more of them.

Since the text displayed in the multi-line edit field of the Start Copying Files dialog is determined by information obtained from the user, there are no settings for this dialog.


Startup Message
The Startup Message is the window which is displayed while your setup is initializing.  It includes a progress bar to inform the user of the preparation status.


Technical Details - Application Information
.

	Technical Details - Application Information
.

Application Name: The information entered in this field is used in several ways:

•	It identifies your application in the static text of the Welcome Message and Choose Destination Location user dialogs.

•	It is used as a directory name in the default path in the Choose Destination Location user dialog.  The default setting for this dialog is C:\Program Files\<Company>\<AppName>.

•	It is used as a keyname in the paths of two automatic registry entries, the uninstall key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\<AppName>

and the registry path which contains the information returned by the User Information user dialog:

HKEY_LOCAL_MACHINE\SOFTWARE\<Company>\<AppName>\<Version>

For more details about these and other keys created by Express, refer to Registry Key Automatic Entries.

•	It is stored under the value "DisplayName" in the uninstall key shown above.  This entry is used to identify your application in the Add/Remove Programs applet.

Application Executable: If there are no entries in either the Groups and Files dialog or the General icon settings dialog, Express will copy the executable specified in this field to the Program Files group, then create an icon entry for the file.

The filename will also be used as the name of the registry key which contains the per-application paths information:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths \<EXEC.EXE>

Note  If you do not specify an EXE file in the Application Executable, Express will not create the per-application paths entry in the registry.

Express also checks the executable for a version resource.  If it finds one, it uses the value stored in the resource as the default entry in the Version field below.

Version: The version you enter in this field is used as a keyname in the user information registry entry detailed in the Application Name description above.

Company: The information entered in this field is also used for the user information registry entry.  Additionally, like the Application Name, it is used as the name of a subdirectory in the Choose Destination Location user dialog.


Test the Installation
.

	Test the Installation
.

After you have successfully run the Disk Builder, you can perform a test setup on your own machine.  All you have to do is click on the Test Run push button.  Express will execute your setup exactly as it would on your user's machine.

You can test your setup as many times as you want.  To save disk space, uninstall your application after each test.

If you are not satisfied with the results of your setup, go back to the dialog(s) you want to change and make your modifications.  Remember to run the Disk Builder again before performing another test run.

Note  If you have made changes since you last ran the Disk Builder, Express will display a message box informing you that you cannot do a test run because the diskettes have not been built.  This safeguard helps ensure that you do not re-test the same setup and "discover" the same mistakes you were trying to fix.  Just run the Disk Builder again, then click on the Test Run push button.

What To Look For in Your Test Run

•	Inspect the visual design of your setup.

Examine the background, any bitmaps or billboards you may have included, and the dialog boxes during the setup.  Make sure that everything you want the user to see is displayed.  Verify that your setup is receiving all of the necessary feedback from the user.  If your installation uses any additional files (such as a License text file or Readme file), verify that they are included in the setup.

•	Make sure your files are copied correctly.

The most important test of all is, of course, whether or not your application was copied correctly and executes properly when launched.

This is especially important if you are using multiple setup types.  Test your compact and custom setups.  Make sure that the compact setup will run.  In your custom setup, examine the descriptions you have written for your components (do they give the user the information he needs to determine whether or not to install each component?)

In general, make sure that all the files your application requires are copied to the desired directories.

•	Check your folders and icons.

Inspect your program folder .  Make sure that the setup created all of the icons your application requires (and that the proper icon images are displayed.

Note  In Windows NT, Express will automatically create the Uninstall icon.

•	Examine your registry changes.

If you specified any additional modifications to the registry, make sure that the changes were made and made correctly.


UNC paths
Universal Naming Conventions (UNC) allow you to access files on shared drives and directories using a sharename rather than a drive letter.  Using the UNC format, you can create a setup that can be built from any node on the network.

In Express, you can use UNC paths anywhere you are specifying the source directory.

UNC paths have the following format:

\\servername\sharename\path\filename.ext

In Windows 95, you can easily specify a UNC path using the Network Neighborhood in Windows Explorer.  Click on the Network Neighborhood icon to reveal the shared drives and/or directories in your network.  Select the appropriate share icon, and locate and select your files.  When you use this method to add files in the Groups and Files dialog, Express will automatically copy the UNC path.

In Express, you can also access Network Neighborhood from the Setup Files Browser.

The ability to support UNC is one of the Windows 95 Logo Requirements.


User Information
.

	User Information
.

The User Information user dialog collects the user's name, company, and, optionally, serial number.

The default setting for this dialog collects all three pieces of information.  If you want to get the user's Name and Company, but not the serial number, click on the Name and Company radio button in the User Information Settings tab.

The information collected from this dialog will be stored in the registry under the following path:

HKEY_LOCAL_MACHINE\SOFTWARE\<Company>\<AppName>\<Version>

The key names <Company>, <AppName>, and <Version> will be determined by the information you entered in the Application Information Express dialog.

The values collected from the User Information dialog will be stored under the value names Name, Company, and Serial (if applicable).


Values
.

	Registry - Values
.

The Registry - Values dialog allows you to set value pairs for the key which was highlighted in the Registry - Key when you clicked on the Registry - Values tab.

The name of the key being modified is displayed in the Registry Key static text field.  If you want to add to or modify values from a different key, simply click on the Registry - Keys tab, highlight the key you want to update, and click on the Registry - Values tab again.

•	To add a value pair:  Click on the Add Value push button to open the Registry Value dialog.  Select one of the radio buttons in the Value Type window to specify whether your data will be in string, binary, 32-bit decimal, or 32-bit hexadecimal format.

Type the name in the Value Name field and the data in the Value Data field.  You can use one of the Express directory specifiers in your data.  Click OK to accept or Cancel to reject your entry.

•	To delete a value pair:  Highlight the name of the value pair you want to delete.  Press the delete key on your keyboard.

•	To modify a value pair:  Highlight the name of the value pair you want to modify.  Click on the Modify Value push button.  The Registry Value dialog will open with the Value Type radio buttons grayed out.  Enter the new name or data in the appropriate field.  Click OK to accept or Cancel to reject your change.

When you are done adding or modifying value pairs for the key, you can click OK to accept your changes, Cancel to reject them, or the [image] tab to select a different key.


Welcome
.

	Welcome
.

Welcome to the next generation of setup toolkits!

InstallShield Express Delphi Edition is the latest addition to the InstallShield family of products.  Express has been designed to make creating a professional-quality 32-bit installation faster and easier than ever before.

•	Its newly designed user interface makes designing and modifying your setup simpler than ever -- you don't need to write a single line of code!

•	All default settings fully conform to Windows 95 Setup Guidelines, including automatic registry entries, uninstallation, and much more.

•	Gives you the features and options you need most, from displaying custom bitmaps and a billboard during the setup to modifying the registry and online registration after the installation.

•	Includes quick and simple distribution to disks or networks.

•	Offers the peace of mind that comes with genuine InstallShield products, which have been used by most leading Software Vendors to create millions of bulletproof, professional-quality installations.

If you're not entirely certain whether you're ready to start building your setup, look at Before You Begin.

To learn more about using this help file, refer to How To Use the Express Help.

If you want to start designing your setup right away, you might want to look at the topics under Planning Your Setup.

Or, of course, you can browse the contents as you please.  You'll find that, in no time at all, you'll be well on your way to creating your installation.

Note  InstallShield Express Delphi Edition is designed to create 32-bit setups only.  If you are interested in a more flexible and powerful setup toolkit, we recommend InstallShield3, the world's most complete and powerful installation software.  Refer to the Readme file for more information about InstallShield3.


Welcome Bitmap
.

	Welcome Bitmap
.

The Welcome Bitmap user dialog allows you to display a bitmap in a child window after the Startup Message, but before any of the other user dialogs.

Note  InstallShield Express Delphi Edition supports only 16-color bitmaps.

Specify your .BMP file on the Welcome Bitmap Settings tab either by using the browse (...) push button to search for the file, or by typing the fully qualified path and filename in the edit field.

Note  The Welcome Bitmap preview is a pre-canned sample.  The previewed image will not change to reflect your specified bitmap.


Welcome Message
.

	Welcome Message
.

The Welcome Message user dialog displays a message welcoming the user to your application's installation, instructions to exit all Windows programs before starting the setup, and a brief copyright warning.

Express will automatically place the application name you entered in the Application Information dialog in the top static text field of the Welcome Message user dialog.

There are no settings for this dialog.


Windows 95 Setup Guidelines
.

	Windows 95 Setup Guidelines
.

One of the primary features of InstallShield Express is that its default settings all conform to the Windows 95 Application Setup Guidelines for Independent Software Vendors, which are part of the Windows 95 Logo Requirements.

Following is an abbreviated list containing some suggestions for conforming with the setup guidelines.  (None of the items listed below is required by Express.)

•	Keep the number of files copied to the WINDOWS or SYSTEM directories to a minimum.

You may still place shared DLLs in the SYSTEM directory.  Express will compare the version number of any such DLLs, as well as any other files to be placed in the SYSTEM directory, and only install your version if it is more recent than the version currently on the target system.

•	Keep the number of icons in your folder to a minimum.

Usability studies have shown that novice users are confused by lots of icons in a program folder.

Ideally, you would have just one icon added directly to the Start Programs menu (you can do this through the Advanced icon settings dialog) and allow access to tutorials, help files, and other applets through the help or tools menu.  This would ensure that the user would not have to open an additional folder, and would always know how to launch the application.

•	Do not make changes to the AUTOEXEC.BAT, CONFIG.SYS, or WIN.INI files.

In Windows 95, you do not need to modify the path in AUTOEXEC.BAT.  Instead, use the per-application paths (App Paths) key in the registry.  Express automatically enters the path for your primary executable under the App Paths key.  You can also specify additional paths under this key.  Refer to the Registry - Keys topic for more information.

Windows 95 also offers you the ability to dynamically load your device drivers without modifying the CONFIG.SYS file.  Design your application to load its drivers when the application is launched.

Information which would have been entered into the WIN.INI file in Windows 3.x or NT should now be loaded into the registry or your private .INI files.  Refer to the Registry - Keys topic for more information about using the registry instead of WIN.INI.

•	Do not remove the automatic uninstallation option.

Express comes complete with unInstallShield.  This program satisfies the Windows 95 Setup Guidelines for uninstallation capability.

The best part is that you don't have to do anything -- just leave the check box on the Features dialog in its default position, selected.

For more information on these concepts, refer to the unInstallShield topic.

For more complete information about Windows 95 Setup Guidelines or Windows 95 Logo Requirements, refer to various topics in the Microsoft Developer Network.


dithered
A dithered background contains two or more colors intermingled to produce gradient shading.  The net effect in InstallShield Express is a background color which is lighter at the top, then appears to gradually darken the further down you look.


unInstallShield
.

	unInstallShield
.

Uninstallation capability is one of the Windows 95 Logo Requirements for your application.  To help you comply with this, InstallShield Express comes complete with unInstallShield.

Unless you deselect the Automatic Uninstaller check box in the Features dialog settings, Express will create an uninstall log file, DEISLx.ISU, which it places in the main installation directory (<INSTALLDIR>).  This file is used to identify the components which must be removed by unInstallShield in case the user decides to uninstall the application.  Express will also copy UNINST.EXE, the unInstallShield executable, to the users main Windows directory (<WINDIR>).

InstallShield creates the necessary folder (Windows 95) or program group (Windows NT) and icon(s) on the user's system.  It creates .LNK files for the items and places them in the FOLDER subdirectory of the main installation directory.  the user executes unInstallShield in Windows 95 by launching Add/Remove Programs out of the Control Panel, highlighting the application name, and clicking on the Add/Remove... push button.  Windows will launch unInstallShield using the command line stored under the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Current Version\Uninstall\<AppName>

Note  In order to comply with Windows 95 Setup Guidelines, all registry entries made during your setup must be removed during an uninstallation.  unInstallShield will remove all automatic registry entries made by Express, but you must set uninstall keys for any additional registry changes  you make.  Refer to Registry - Keys for more information.

In Windows NT, the user launches unInstallShield by double-clicking on its icon in your application's program group.  This icon is automatically created by Express during your setup unless you deselect the uninstall option.