Files Created for Your Wizard
Your wizard uses the name that you specify in the Name box in the New Project dialog box to derive names for some files and classes.
The Custom Wizard adds comments to the files it creates for your project. The Custom Wizard also creates a text file, ReadMe.txt, in your new application directory. This file explains the contents and uses of the other new files created by the Custom Wizard.
The following table describes the files created by the Custom Wizard. For more information on how the key elements interact to create a wizard, see Designing a Wizard.
File |
Description |
---|---|
A text file similar to the old .ini format. It identifies the wizard engine and provides context and optional custom parameters. |
|
A text file that provides a routing service between the Visual Studio shell and the items in the wizard project. |
|
A wizard can contain a user interface (UI), which is an HTML interface. A file without a UI contains no HTML files. Default.htm is the file that specifies features in the UI. If you specify more than one page in Application Settings of the Custom Wizard, the additional files are each named Page_PageNum.htm. |
|
A wizard accesses the script engine and creates a JScript file, Default.js, for each project. It also includes Common.js. These files contain JScript functions that access the Visual C++ Wizard, Code, and Environment Object Models to customize a wizard. You can customize and add functions in the wizard project's Default.js file. |
|
A wizard's templates are a collection of text files that contain directives, which are parsed and inserted into the symbol table, depending on the wizard user's selections. The template text files are rendered according to the user input and added to the project. The appropriate information is obtained by directly accessing the wizard control's symbol table. |
|
A text file that lists all templates associated with the project. |
|
Default.vcproj |
An .xml file that contains the information on the project type. |
Sample.txt |
A template file that shows how your wizard directives are used. |
ReadMe.txt |
A template file that contains a summary of each file created by the Custom Wizard. |
Images (optional) |
You can provide any images, such as icons, GIFs, BMPs, and other HTML-supported image formats, to enhance the UI for your wizard. A wizard that has no UI does not need images. |
Styles.css (optional) |
A file that defines the styles for the UI. If your wizard does not have a user interface, the Custom Wizard does not create a .css file. |
Note If you delete your wizard files and directories, you must also delete the following files from the vc7\vcprojects directory. Until you delete these files, icons for your wizard will continue to appear in the New Project dialog box.
projectname.vsz
projectname.ico
projectname.vsdir
Additionally, your wizard includes the file Common.js, which contains commonly used JScript functions and is shared among all wizards, including the wizards used by Visual C++ to create other project types. See Customizing C++ Wizards with Common JScript Functions for more information.
See Also
Tasks
Concepts
Customizing C++ Wizards with Common JScript Functions