Custom Parameters in the Wizard .vsz File
In its first two lines, the .vsz file identifies the wizard version and the ProgID or CLSID of the wizard to be cocreated. The .vsz file can also include optional context parameters and custom parameters that are added to the symbol table (along with the symbols supplied in the HTML symbol section).
The Execute method displays the wizard, which takes an array of the context and custom parameters defined in the .vsz file as its parameters.
The following commonly used symbols are specified as custom parameters in either the .vsz file or the .htm files and can be used in wizard HTML, script, or template files.
Example
As the following .vsz file entries indicate, the wizard named MyProjWiz contains a user interface.
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"
Symbols for Custom Parameters in the Wizard .vsz File
Symbol |
Definition |
|---|---|
ABSOLUTE_PATH |
The location of the wizard files. |
HTML_FILTER |
Specified in the .vsz file. File types that are placed in the HTML Files folder in Solution Explorer. Usually specified as "htm". |
HTML_PATH |
Specified in the .vsz file. The location of the wizard's HTML files. By default, it is START_PATH\HTML\LANGUAGE (where LANGUAGE is the locale specified by your system registry). Note You can specify a different language by setting the <LangID> to the decimal value of HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage. See Localizing a Wizard to Multiple Languages for more information. For a list of decimal language values, see Wizard Support for Other Languages. |
IMAGE_FILTER |
Specified in the .vsz file. File types that are placed in the Image Files folder in Solution Explorer. Usually specified as "bmp;gif". |
IMAGES_PATH |
Specified in the .vsz file. The location of the image files used in the html files. By default, it is START_PATH\Images. |
MISC_FILTER |
Specified in the .vsz file. File types that are placed in the Misc folder in Solution Explorer. Usually specified as "vsz;vsdir;ico;vcproj;csproj;css;inf". |
PRODUCT |
By default, set to Visual C++; however, you can set this value to Visual Basic to create Visual Basic wizards, and so on. |
PRODUCT_INSTALLATION_DIR |
The directory listed in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Product>\ ProductDir. |
PROJECT_TEMPLATE_NAME |
Specified in the .vsz file. The project template file that your wizard uses to create projects. Usually specified as "txt". |
PROJECT_TEMPLATE_PATH |
The directory containing the project's template files. For Visual C++, it is PRODUCT_INSTALLATION_DIR\VCWizards, by default. |
RELATIVE_PATH |
If ABSOLUTE_PATH is not found, then RELATIVE_PATH is considered. This is the path relative to PRODUCT_INSTALLATION_DIR. For Visual C++, the RELATIVE_PATH is PRODUCT_INSTALLATION_DIR\VCWizards. |
SCRIPT_COMMON_PATH |
The directory name relative to PRODUCT_INSTALLATION_DIR, where the common script file can be found. For example, for Visual C++, this is VCWizards. |
SCRIPT_FILTER |
Specified in the .vsz file. File types that are be placed in the Script Files folder in Solution Explorer. Usually specified as either "js" (JScript) or "vbs" (VBScript). |
SCRIPT_PATH |
The location of the wizard's JScript file. By default, it is START_PATH\Scripts |
START_PATH |
Specified in the .vsz file. This is not set by the user, but used internally to identify either RELATIVE_PATH or ABSOLUTE_PATH. The wizard name (WIZARD_NAME) is appended to this value. |
TEMPLATE_FILTER |
Specified in the .vsz file. File types that are placed in the Template Files folder in Solution Explorer. Usually specified as "txt". |
TEMPLATES_PATH |
Specified in the .vsz file. The location of the wizard's template files. By default, it is START_PATH\Templates\<LangID>. Note See HTML_PATH for more information on LangID. |
WIZARD_NAME |
Specifies the wizard name. Located in the .vsz and used by the rest of the symbols. |
WIZARD_UI |
Specified in the .vsz file. A Boolean value indicating whether the wizard contains a user interface. Specify TRUE for a user interface or FALSE for no user interface. |