PAGELAYOUTVTML 2

PAGELAYOUT defines the canvas on which containers and controls can be laid out for a Wizard page.

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
EDITORLAYOUT and PAGELAYOUT sections
VTML for Wizards
PAGE
Container for
CONTAINER
CONTROL
Related tags
EDITORLAYOUT (Tag Editors)

top

Tools

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

  1. Wizard

top


Location

This tag can occur only within a PAGE tag with TYPE="Dynamic" in a Wizard profile file.

top


Function

Defines the canvas on which containers and controls can be laid out for a page in the Wizard user interface. This tag is used only on pages with TYPE="Dynamic". It does not take any attributes. Unlike EDITORLAYOUT for a Tag Editor which can have WIDTH and HEIGHT defined, a Wizard has a fixed size of 488 x 388 pixels (or 610 x 485 when Large Fonts are used) so PAGELAYOUT does not have (or need) WIDTH and HEIGHT attributes. The lower part of the Wizard has the standard navigation buttons, and on the left is a bitmap, either the default one or another defined with the IMAGE attribute for the PAGE tag. The remainder is available as a canvas for laying out containers and controls. Usage notes can be found in the documentation about Wizards.

top


Syntax and Attributes

<PAGELAYOUT> </PAGELAYOUT>
(No attributes)

top


Usage Notes

Laying out controls
The page caption (defined with the CAPTION attribute of the PAGE tag) is displayed in a Times New Roman font (14pt). The caption is displayed in a bounded box of fixed size; if you define a second line (with \n) for the caption, this second line will be mostly cut off by this bounded box. The outline of the box itself is invisible, but it's there. The DOWN attribute of the first container or control on the page is relative to the bottom of this box. The usable area below the caption box for laying out controls is 300 x 270 (or approximately 425 x 403 when Large Fonts are used). This leaves a page margin on the right of about 10 pixels. Unlike with Tag Editors, where the page itself (above the standard buttons) forms the limiting box, with a Wizard this imaginary box forms the limit of the usable canvas.

If you want to make full use of this space for a TextBox or TextArea by specifying WIDTH="MAXIMUM" or HEIGHT="MAXIMUM", you should also set the corresponding MAXWIDTHPADDING or MAXHEIGHTPADDING to 0 since these attributes default to 10.

More information about laying out controls is found in EDITORLAYOUT and PAGELAYOUT sections

top