MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION..., Use Manual

Page: 166 / 236

174
Creating Wizard Definition Pages
The first step in building a custom wizard is to write a VTML file to define the interface
and output parameters. This section describes the VTML tags used in this part of the
process and presents an example definition file.
VTML for Wizards tag summary
The following is the hierarchy of the tag set for wizard definition files:
WIZARD — The enclosing tag for the entire file; it defines the new wizard with a name,
caption and default image.
PARAM — When used as a sub-tag of the WIZARD tag, it defines a parameter that the
wizard uses to generate its output. These parameters are then available for use with
wizard output templates.
TEMPLATE — Defines an output template and identifies the file used for text output.
PAGE — Defines a wizard page that determines which page class to load.
PARAM — When used as a sub-tag of the PAGE tag, it sets the behavior of a page class.
This is useful for standard pages which are intended to be re-used across multiple
wizards.
INPUT — Defines an input control on a wizard page. If the NAME attribute of the
INPUT control matches both the name of a control on the wizard page as well as the
name of a PARAM defined within the WIZARD tag then the control is automatically
‘bound’ to the underlying parameter without requiring any explicit code.
NEXTPAGE — The NEXTPAGE tag allows for complex routing between pages based on
the value of conditional expressions.
PAGELAYOUT — Same as VTML syntax for containers and controls.
VTML for Wizards tag reference
The following tables provide the complete VTML syntax for writing wizard definition
files.
The following table describes the WIZARD tag.
Attribute Description
NAME Optional. Used to resolve the names of pages that belong to a specific
wizard. May be registered using the syntax
WizardName.PageName.
CAPTION Optional. Caption to display in the wizard’s title bar.
IMAGE Optional. Default bitmap to use for pages within the wizard.