The WIZARD tag is the outermost tag for Wizard definition profiles, similar to HTML for HTML documents or TAG for tag definitions: it encloses the entire document. It is required for a Wizard definition profile.
The following subjects are covered in this document:
Related information about VTML and WIZML:
|
WIZARD plays a role in the following VTML-driven tools:
The WIZARD tag is the outermost tag for Wizard profile files.
The WIZARD tag is the outermost tag of a Wizard profile; just like the TAG tag for a Tag Definition and the HTML tag for an HTML page.
It can take three attributes. As with the TAG tag, the NAME attribute is only a (useful) comment. CAPTION is useful from a user interface design standpoint (what is a title bar without a title?), while with the IMAGE attribute a default bitmap can be defined.
<WIZARD ...> </WIZARD> | |
---|---|
NAME | For custom Wizards this is only a comment, but useful for documentation. |
CAPTION | Caption to display in the Wizard's title bar. Recommended but not technically required. (If no caption is defined, the title bar will be empty.) |
IMAGE | Default bitmap to use for pages within the Wizard. The size should be 138 x 293 pixels. Recommended. |
IMAGE
If the image file specified for the IMAGE attribute is not found, an empty placeholder will be shown on all pages without an IMAGE attribute.
If it is found, it will be shown on every page without an IMAGE attribute. Although this attribute is not required, it is highly recommended:
without a default file defined here, the Wizard Output Summary page will not have an image!
IMAGE path syntax
While the printed manuals and examples show the path syntax for an IMAGE with '\\' (an escaped backslash!) as level separators, other formats
are accepted, both for WIZARD and for PAGE. Double forward slashes ('//') are possible, too (!), and so are normal URL-style single forward slashes.
(Backslashes must be escaped; otherwise the parser will not be able to completely read the Wizard profile file and return an error message.)
Since the form with single forward slashes is what is normally returned by a FileBrowser control (as used in a Tag Editor or in Tag Inspector), this is the
preferred form.
Examples:
<WIZARD NAME="DefaultTemplate" CAPTION="Default HTML Template" IMAGE="../images/table.bmp"> <WIZARD NAME="AdminFormWizard" CAPTION="Admin Form Wizard" IMAGE="..//images//edit.bmp"> <PAGE NAME="Page2" CAPTION="Data Source" IMAGE="..\\images\\SelectData.bmp" TYPE="SelectDataSource">