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:
|
| 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.