SELECT XHTML Element (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

The SELECT element 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.

This element can be used within a web page with attributes.

This element can be used within scripts where it will have properties, events, methods and collections.

Attributes

The following table shows items that Internet Explorer Embedded 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 OPTION element) 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 accesskey attribute.
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 SELECT object.
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.
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.

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 SELECT control. 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 SELECT control.
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. sAttrName is a String containing the name of the attribute. iFlags is 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 sAttrName must 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.
remove	option	Removes the SELECT control.

Scripting Collections

Collections Arguments Support Comments

Collections	Arguments	Support	Comments
options		Yes	Retrieves a collection of OPTION objects in a SELECT object. 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

options

Yes

Retrieves a collection of OPTION objects in a SELECT object.

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 Embedded CE

Windows Embedded CE 6.0 R3