ITEM

The ITEM tag defines one possible choice in a CONTROL with multiple choices.

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
CONTROL

top

Tools

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

  1. Tag Editor
  2. Wizard

top


Location

This tag can occur only within a CONTROL tag with TYPE="DropDown", TYPE="ListBox" or TYPE="RadioGroup".

top


Function

Item is used as part of a DropDown control, a ListBox control or a RadioGroup control; each item represents one possible choice.

top


Syntax and Attributes

<ITEM .../>
VALUE Value that will be returned when this item is selected.
CAPTION Text that is displayed to describe the choice.
SELECTED FLAG. If specified, pre-selects the choice represented by this item.
Note: if the ITEM is part of a ListBox control that has the MULTISELECT flag, SELECTED is not operational.

top


Examples

<CONTROL TYPE="Label" NAME="lblAlign" WIDTH=50 CAPTION="Align:" ANCHOR="lblSource" CORNER="SW" DOWN=10/>

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

top