Platform SDK: Web Telephony Engine

SELECT

<SELECT
CLASS=classname
DISABLED
ID
=value
MULTIPLE
NAME
=name
STYLE=css1-properties
VOICEFILE=url
LANGUAGE=JAVASCRIPT | JSCRIPT | VBSCRIPT | VBS
event = script
>

Serves as a menu owner, with all the enclosed OPTION elements as menu items.

Attributes

CLASS= classname
Specifies the class of the element being defined. This is used to associate a subclassed style sheet with the element.
DISABLED
Used to disable an element. Does not affect whether the SELECT breaks a menu.
ID= value
An SGML ID used as the target for hypertext links or for naming particular elements in associated style sheets. Valid ID values must begin with a letter. The underscore ("_") can be used in the ID name. The ID should be unique throughout the document. If more than one object with the same ID exists in a document, a collection of those named items is created that can only be referenced only by ordinal position.
MULTIPLE
Indicates a multiple selection menu. Multiple-selection SELECT element starts their operation in a way similar to the single-selection SELECT element. Multiple selections can be made until the termination key is pressed.
NAME= name
Specifies the name of the control, bookmark, or applet.
STYLE= css1-properties
Specifies an inline style sheet for the element.
VOICEFILE= url
Specifies the voice file attached with this element.
LANGUAGE= JAVASCRIPT | JSCRIPT | VBS | VBSCRIPT
Specifies the language in which the current script is written and invokes the proper scripting engine. The default value is JAVASCRIPT.
Language Description
JAVASCRIPT, JSCRIPT The scripting language is written in JScript.
VBS, VBSCRIPT The scripting language is written in VBScript.

event
Can be one or more of these events:

onchange

onselectiontimeout

onselectionerror

Remarks

Both the start and end tags are required.

The announcement of the multiple-selection menu created by using the SELECT element with the MULTIPLE attribute includes all audio items (either voice files or textual) gathered before the element, the cue-before CSS property and the VOICEFILE attribute on the SELECT element, the voice files and cues from all of the OPTION elements, and finally, the cue-after CSS property on the SELECT element. When a caller makes a choice, the announcement of the menu starts from the item that is next to the chosen one. If an error (either a time-out or an non-valid key) is detected, announcements of all menu items are rendered excluding those that were already chosen. Audio items on the SELECT control itself are always rendered.