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.
A version of this page is also available for
4/8/2010

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.

Note:
Supported only on Windows Mobile 2003 and later.

CLASS

 

Associates the element with a CSS style.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

DISABLED

 

Disables the element so that it appears dimmed and does not respond to user input.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

ID

 

Uniquely identifies the element within a document.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

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.

Note:
Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.

ONCHANGE

 

Event that occurs when the select control loses the input focus and its value has been modified since gaining focus.

Note:
Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.

ONFOCUS

 

Event that occurs when the select control receives focus by a pointing device or by tabbing navigation.

Note:
Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.

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.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

TABINDEX

 

Sets the order in which elements are tabbed to.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

Scripting Properties

Property Type Access Comments

accessKey

string

Read/Write

Sets or retrieves the number associated with the accesskeyattribute.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

disabled

boolean

Read/Write

Sets or retrieves the value that indicates whether the user can interact with the object.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

form

object

Read Only

Retrieves a reference to the form that the object is embedded in.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

length

long

Read Only

Sets or retrieves the number of select objects in a collection.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

multiple

boolean

Read Only

Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

name

string

Read Only

Sets or retrieves the name of the SELECTobject.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

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.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

type

string

Read Only

Always returns one of the following options:

  • Select-one for SELECTcontrols without the multipleattribute.

  • Select-multiple for SELECTcontrols with the multipleattribute.

value

string

Read/Write

Sets or retrieves the values of the SELECTtag.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

Scripting Events

Event Comment

onblur

Occurs when an element loses focus either by the pointing device or by keypad navigation.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

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.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

Scripting Methods

Method Arguments Comments

add

option

Adds the SELECTcontrol.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

focus

 

Syntax:

select.focus()

  • This method sets the focus to the SELECT control.

getAttribute

option

Syntax:

vAttrValue=select.getAttribute(sAttrName[,iFlags])

  • Returns the value of the specified attribute. If the attribute is not present then a NULL is returned.

    sAttrNameis a String containing the name of the attribute.

    iFlagsis an integer that specifies one or more of the following:

    0 (Default) Performs a property search that is not case-sensitive, and returns an interpolated value if the property is found.

    1 Performs a case-sensitive property search. To find a match, the uppercase and lowercase letters in sAttrNamemust exactly match those in the attribute name.

    2 Returns the value exactly as it was set in script or in the source document.

item

([optional] variant name, [optional] variant index)

Retrieves a node specified by ordinal index.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

remove

option

Removes the SELECTcontrol.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

Scripting Collections

Collections Arguments Support Comments

options

 

Yes

Retrieves a collection of OPTIONobjects in a SELECTobject.

Syntax:

[colOptions=]select.options

[oObject=]select.options(vIndex)

colOptions:

  • Collection of options

oObject:

  • Reference to an individual item in the array of elements contained by the object.

vIndex:

  • Required. Integer that specifies the element to retrieve. The value of vIndex cannot be accessed as a string.

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

See Also