combo tag

A combo tag references a DataCollection in the context hierarchy and creates an HTML select element using the collection's inner elements.

Mandatory attributes: dataNameForList, dataName. If the DataCollection is an IndexedCollection, item and value are mandatory.

Table 1. combo tag attributes
Attribute Description Default value
dataName

ForList
ID of the DataCollection.

If the DataCollection is a KeyedCollection, each inner DataField corresponds to an option element. The combo box uses the field ID as the option label and the field value as the option value.

If the DataCollection is an IndexedCollection, the inner elements must be KeyedCollections, and the item and value attributes are mandatory. Each inner KeyedCollection corresponds to an option element. The combo box uses the collection field named in the item attribute as the option label and uses the collection field named in the value attribute as the option value. If the data element named dataName contains the value of an option element, the combo box highlights this option element as selected (it is the default).
dataName Name of the DataField in the context hierarchy. If the DataField is read only, in Internet Explorer the combo box is also read only.

If a form containing a combo box is submitted, the context's element named dataName is set with the combo box value.
item Collection field to use as the option label null
value Collection field to use as the option value null
style Style for the combo box null
custom Adds attributes to the input element. The following is the format of this attribute:

custom="att1Name=\"att1Value\

"att2Name=\"att2Value\"..."
null

The following is an example of using ComboBoxTag:

<H1>Using the combo tag</H1>
<btt:form name="f1" nextEventName="ok">
<btt:combo dataName="selectedMaritalStatus2" dataNameForList="availableMaritalStatus"/><br>
<btt:combo dataName="selectedPreferredPhone2" dataNameForList="phonesList" item="name" 
    value="type"/>
</btt:form>