PAGEVTML 2

Each PAGE defines one of the pages of a Wizard that the user navigates through.

The following subjects are covered in this document:


Related information about VTML and WIZML:

Tutorial
The Visual Tool Markup Language (VTML)
Reference
VTML reference - overview
Context
VTML for Wizards
Container for
PARAM
PAGELAYOUT
INPUT
NEXTPAGE

top

Tools

PAGE plays a role in the following VTML-driven tools:

  1. Wizard

top


Location

This tag can occur only within the WIZARD tag in a Wizard profile file.

top


Function

Each PAGE defines one of the pages of a Wizard that the user navigates through by means of the < Back and Next > buttons.

top


Syntax and Attributes

<PAGE ...> </PAGE>
TYPE Required for custom Wizards. Possible values can classified in two groups:
NAME Required. Name of the page.
CAPTION Required. Caption to display in the top portion of the page. Displayed in a Times New Roman font (14pt). Must be defined, but the value can be an empty string to suppress a caption being displayed.
IMAGE Override of the default wizard bitmap. The size should be 138 x 293 pixels; it is scaled automatically when Large Fonts are used.
CONDITION Conditional expression which determines if the page is displayed.
NEXTPAGE Name of page to go to after the current one. The default page is the next page defined in the Wizard profile file.

top


Usage Notes

NAME
A page NAME must be unique within a wizard. Page names are used with the NEXTPAGE attribute of PAGE and with the NEXTPAGE tag. You can  have different pages of the same TYPE, as long as they have different names.

CAPTION
Defaults to "Dynamic Wizard Page" if the caption is defined as an empty string. Can be only a single line since it's displayed in a bounded box: a second line (started with \n) will be mostly cut off. The DOWN attribute (specified or implied) of the first control is relative to the bottom of this bounded box. See also the usage note for the PAGELAYOUT tag.

IMAGE
If the image file specified for the IMAGE attribute is not found, an empty placeholder will be shown. If no IMAGE attribute is specified, the default image defined in the WIZARD tag will be shown. See also the IMAGE path syntax described in the Usage Notes for WIZARD.

CONDITION
The CONDITION attribute on a page has a higher priority than that of a NEXTPAGE tag leading to this page: Even if the condition of NEXTPAGE would cause the page to be shown, if the condition in the page itself is not true, the page will not appear.

top