CONTAINER

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

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.

Container types

The following containers can be used in VTML:

CONTAINER TYPE="TabDialog"

Function

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

Syntax and Attributes

<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>

CONTAINER TYPE="TabPage"

Function

The TabPage control can only be contained inside a TabDialog CONTAINER control.

Syntax and Attributes

<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>

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

<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