Share via


SELECT HTML Object

The SELECT object denotes a list box or drop-down list.

Properties

Property Data type Access Description
accesskey String Read/write Sets or retrieves the number associated with the accesskey attribute.
Note   Supported only for devices running Windows Mobile 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 Windows Mobile 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 Windows Mobile 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 Windows Mobile 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 Windows Mobile 2002 software or later.
name String Read-only Sets or retrieves the name of the SELECT object.
Note   Supported only for devices running Windows Mobile 2002 software or later.
selectedIndex Long Read/write Sets or retrieves the index of the selected option in a SELECT object. 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 SELECT object with the multiple attribute 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 Windows Mobile 2002 software or later.
type String Read-only Always returns one of the following options:
  • Select-one for SELECT controls without the multiple attribute.
  • Select-multiple for SELECT controls with the multiple attribute.
value String Read/write Sets or retrieves the values of the SELECT tag.
Note   Supported only for devices running Windows Mobile 2002 software or later.

Events

Event Description
onchange Occurs when the user changes the selection in the SELECT control. It does not occur when the selection is changed programmatically.
onblur Occurs when an element loses focus either by the pointing device or by keypad navigation.
Note   Supported only for devices running Windows Mobile 2002 software or later.
onfocus Occurs when an element receives focus either by the pointing device or by tabbing navigation.
Note   Supported only for devices running Windows Mobile 2002 software or later.

Methods

Method Syntax Description
add select.add Adds the SELECT control.
Note   Supported only for devices running Windows Mobile 2003 software or later.
focus select.focus Sets focus to the SELECT control.
item select.item Retrieves a node specified by ordinal index.
Note   Supported only for devices running Windows Mobile 2002 software or later.
remove select.remove Removes the SELECT control.
Note   Supported only for devices running Windows Mobile 2003 software or later.

Collections

The following collection is supported for the SELECT object:

Requirements

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.