Designing an Object’s Wizard

InstallShield 2019

When you include properties in your object, it is a good idea to provide an interface for the users of your object to modify those properties. InstallShield can create a stock wizard for you based on the properties that you created, or you can create your own wizard using Visual Basic or Visual C++.

The InstallShield Stock Wizard

The InstallShield stock wizard is well-suited for in-house use of your object. The stock wizard displays all of your read-only properties and provides an edit field for your read/write properties.

There are a few limitations of the stock wizard that can be overcome by using a custom wizard. For example, the stock wizard cannot be customized to fit your needs. You cannot pick and choose which properties you would like to display, nor can you customize the way the wizard looks. If you would like to create a customized interface for your wizard, you will need to create your own wizard in Visual C++ or Visual Basic. Another drawback of the stock wizard is that it does not provide support for array properties. Although the stock wizard has a few limitations, it is simple to implement and use.

Custom Wizards

If you need to provide a more professional look to your wizard, greater functionality, or customized display, you should create your own wizard using Visual C++ or Visual Basic. If you had these applications installed before you ran the InstallShield installation, the functionality to create an InstallShield object wizard will have been added. If you installed either of these programs after you installed InstallShield, you will need to run the InstallShield installation in maintenance mode in order to add the wizard functionality to your Visual Studio application. To create an InstallShield object wizard in Visual C++, click New on the File menu. Then, select InstallShield Object Wizard from the list of project types. In Visual Basic, select InstallShield Object Wizard from the New Project dialog box.

When you create an InstallShield Object Wizard project in Visual C++, a new ATL-MFC based VC wizard framework project will be displayed. In Visual Basic, a template project will be created. Commented code within the each project type shows how to retrieve and save the object properties. For more information, see Custom Object Wizards.

When you are finished creating your wizard, compile it.

Note • When you are distributing an object that has a custom wizard, make sure to include any dependencies for the wizard .dll file in the distribution installation project. Include the required files in a feature that you place above the InstallShield Object Installer feature in the Setup Design or Features view. You can avoid having dependencies by creating a static wizard .dll file.

Specifying Whether to Use the InstallShield Stock Wizard or a Custom Wizard

To specify whether you want to use the InstallShield stock wizard or a custom wizard that you have created:

1. In the View List under Installation Information, click General Information.
2. Do one of the following:
If you want to use the stock wizard: In the Object Wizard setting, select Use InstallShield Object Stock Wizard.
If you want to use your own custom wizard: In the Object Wizard setting, click the ellipsis button (...). The Browse for My Custom Object Wizard dialog box opens. Select the wizard file that you created for your object.

When you build a release for your project, the object will include the wizard that you specified.