CONTAINER

Containers are used to organize controls in a user interface into logical groups.

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
Container for
CONTAINER
CONTROL

top

Tools

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

  1. Tag Editor
  2. Wizard

top


Location

A CONTAINER tag can be used within either the EDITORLAYOUT section of a Tag Definition or the PAGELAYOUT section of a Wizard profile file. It can occur either directly within these tags or within another CONTAINER tag.

top


Container types

The following containers can be used in VTML:

top



CONTAINER TYPE="TabDialog"

Function

The TabDialog control is a special container control, as it can only contain <CONTAINER TYPE="TabPage"> tags. This is natural as one needs to specify the tab pages before embedding more controls on the tab dialog itself.

Syntax and Attributes

Defaults indicated in bold.

<CONTAINER TYPE="TabDialog" ...> </CONTAINER>
NAME The name of the TabDialog becomes the name of the variable to query to find out which TabPage was chosen.
MULTILINE FLAG. If specified, tabs can occupy multiple rows, otherwise if there are more tabs than fit on one row, a scroll control will appear.
HORIZRESIZE Obsolete.
VERTRESIZE Obsolete.

Examples

<CONTAINER TYPE="TabDialog" NAME="DisplayType" WIDTH="MAXIMUM" HEIGHT="MAXIMUM">
    <CONTAINER TYPE="TabPage" NAME="Type1" CAPTION="TEXTAREA Tag">
        ... embedded controls
    </CONTAINER>
    <CONTAINER TYPE="TabPage" NAME="Type2" CAPTION="Content">
        ... embedded controls
    </CONTAINER>
</CONTAINER>

top


CONTAINER TYPE="TabPage"

Function

The TabPage control is also a bit special as it can only be contained inside a TabDialog CONTAINER control.

Syntax and Attributes

Defaults indicated in bold.

<CONTAINER TYPE="TabPage" ...> </CONTAINER>
NAME In the ATTRIBUTES section of a Tag Definition, a TabDialog can be bound as a CONTROL to an attribute named TYPE. (See example below.) The value of the variable corresponding to this control will be the name of the selected TabPage. This variable can then be queried in WIZML to find out which TabPage was selected when the dialog was accepted by the user.
CAPTION Caption displayed on the top of the tab. The text shown defaults to the value of the NAME attribute if CAPTION is omitted.

Examples

This Example shows how the name of the TabDialog and the names of the TabPages are used in the <ATTRIBUTES> section and the <TAGLAYOUT> section to control which variables are used to write out code.

<EDITORLAYOUT>
    <CONTAINER TYPE="TabDialog" NAME="ControlType" WIDTH="MAXIMUM" HEIGHT="MAXIMUM">
        <CONTAINER TYPE="TabPage" NAME="Type1" CAPTION="TEXTAREA Tag">
            ... embedded controls
        </CONTAINER>
        <CONTAINER TYPE="TabPage" NAME="Type2" CAPTION="Content">
            ... embedded controls
        </CONTAINER>
    </CONTAINER>
</EDITORLAYOUT>

<ATTRIBUTES>
    <ATTRIB NAME="TYPE" CONTROL="ControlType"/>
    ...
</ATTRIBUTES>

<TAGLAYOUT>
    <WIZIF ControlType EQ 'Type1'>
        ... handle controls for Type1
    <WIZELSEIF ControlType EQ 'Type2'>
        ... handle controls for Type2
    </WIZIF>
</TAGLAYOUT>

top


CONTAINER TYPE="Panel"

Function

Panel is the most common container control. Panel can contain any control or container except TabPage which is restricted to TabDialog.

Syntax and Attributes

Defaults indicated in bold.

<CONTAINER TYPE="Panel" ...> </CONTAINER>
CAPTION Caption displayed in the upper left corner of the panel boundary.
HORIZRESIZE Obsolete.
VERTRESIZE Obsolete.

Examples

<EDITORLAYOUT WIDTH=4705>
   <CONTAINER TYPE="TabDialog" NAME="MainTabDialog" WIDTH="MAXIMUM" HEIGHT="MAXIMUM">
      <CONTAINER TYPE="TabPage" NAME="TabPage1" CAPTION="MYTAG Tag">
         <CONTAINER TYPE="Panel" NAME="Panel1" WIDTH="MAXIMUM" HEIGHT=125 DOWN=5 RIGHT=10>
             <CONTROL TYPE="Label" NAME="lblSource" WIDTH=50 DOWN=15 RIGHT=10 CAPTION="Source:"/>
             <CONTROL TYPE="TextBox" NAME="txtSource" WIDTH="MAXIMUM" ANCHOR="lblSource" CORNER="NE"/>

             <CONTROL TYPE="Label" NAME="lblAlign" WIDTH=50 ANCHOR="lblSource" CORNER="SW" DOWN=10 CAPTION="Align:"/>
             <CONTROL TYPE="DropDown" NAME="dropAlign" WIDTH=100 ANCHOR="lblAlign" CORNER="NE">    
                  <ITEM VALUE="TOP" CAPTION="TOP"/>
                  <ITEM VALUE="MIDDLE" CAPTION="MIDDLE" SELECTED/>
                  <ITEM VALUE="BOTTOM" CAPTION="BOTTOM"/>
             </CONTROL>
        </CONTAINER>

        <CONTAINER TYPE="Panel" NAME="Panel2" WIDTH="MAXIMUM" HEIGHT="MAXIMUM"
             ANCHOR="Panel1" CORNER="SW" DOWN=5 CAPTION=" Panel 2 ">
        </CONTAINER>
		
     </CONTAINER>

     <CONTAINER TYPE="TabPage" NAME="Advanced" CAPTION="Advanced">
     </CONTAINER>

   </CONTAINER>

</EDITORLAYOUT>

top