Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The SELECTelement denotes a list box or drop-down list. This is an inline element and requires a closing tag.
Using this Element
There are some common properties and collections that apply to all the elements of the document object model, see Common Properties, Methods and Collections for the HTML Elements in Internet Explorer Mobile.
This element can be used within a web page with attributes.
This element can be used within scripts where it will have properties, events, methodsand collections.
Attributes
The following table shows items that Internet Explorer Mobile supports.
Attribute | Value | Description | ||
---|---|---|---|---|
ACCESSKEY |
0…9, #, * |
Gives access or focus to an active HTML element by using a keyboard character.
|
||
CLASS |
|
Associates the element with a CSS style.
|
||
DISABLED |
|
Disables the element so that it appears dimmed and does not respond to user input.
|
||
ID |
|
Uniquely identifies the element within a document.
|
||
MULTIPLE |
|
Specifies that multiple items that can be selected. |
||
NAME |
String |
Specifies a name for the select control, which is submitted (a name or value pair for each selected OPTIONelement) so that script can reference the control. |
||
ONBLUR |
|
Event that occurs when the select control loses focus by the pointing device or by tabbing navigation.
|
||
ONCHANGE |
|
Event that occurs when the select control loses the input focus and its value has been modified since gaining focus.
|
||
ONFOCUS |
|
Event that occurs when the select control receives focus by a pointing device or by tabbing navigation.
|
||
SIZE |
0…# |
Specifies the select control size. When the default value 1 is used, a combo box is rendered. For values greater than 1, a list box is rendered |
||
STYLE |
|
Provides the definition of the CSS styles used for this element.
|
||
TABINDEX |
|
Sets the order in which elements are tabbed to.
|
Scripting Properties
Property | Type | Access | Comments | ||
---|---|---|---|---|---|
accessKey |
string |
Read/Write |
Sets or retrieves the number associated with the accesskeyattribute.
|
||
disabled |
boolean |
Read/Write |
Sets or retrieves the value that indicates whether the user can interact with the object.
|
||
form |
object |
Read Only |
Retrieves a reference to the form that the object is embedded in.
|
||
length |
long |
Read Only |
Sets or retrieves the number of select objects in a collection.
|
||
multiple |
boolean |
Read Only |
Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.
|
||
name |
string |
Read Only |
Sets or retrieves the name of the SELECTobject.
|
||
selectedIndex |
long |
Read/Write |
Sets or retrieves the index of the selected option in a SELECTobject. This index is 0-based and returns -1 if no items are selected. Setting this property clears any existing selected items. This property is not useful for the SELECTobject with the multipleattribute because it returns the index of only the first selected option. |
||
size |
long |
Read Only |
Sets or retrieves the size of the control.
|
||
type |
string |
Read Only |
Always returns one of the following options:
|
||
value |
string |
Read/Write |
Sets or retrieves the values of the SELECTtag.
|
Scripting Events
Event | Comment | ||
---|---|---|---|
onblur |
Occurs when an element loses focus either by the pointing device or by keypad navigation.
|
||
onchange |
Occurs when the user changes the selection in the SELECTcontrol. It does not occur when the selection is changed programmatically. |
||
onfocus |
Occurs when an element receives focus either by the pointing device or by tabbing navigation.
|
Scripting Methods
Method | Arguments | Comments | ||
---|---|---|---|---|
add |
option |
Adds the SELECTcontrol.
|
||
focus |
|
Syntax:
|
||
getAttribute |
option |
Syntax:
|
||
item |
([optional] variant name, [optional] variant index) |
Retrieves a node specified by ordinal index.
|
||
remove |
option |
Removes the SELECTcontrol.
|
Scripting Collections
Collections | Arguments | Support | Comments |
---|---|---|---|
options |
|
Yes |
Retrieves a collection of OPTIONobjects in a SELECTobject. Syntax:
|
length |
long |
Read Only |
Retrieves the number of options in the collection. |
item |
([optional] variant name, [optional] variant index) |
Yes |
|
Requirements
Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |