org.w3c.dom.html

Interface HTMLSelectElement

public interface HTMLSelectElement extends HTMLElement

The select element allows the selection of an option. The containedoptions can be directly accessed through the select element as acollection. See the SELECT element definition in HTML 4.0.
Method Summary
voidadd(HTMLElement element, HTMLElement before)
Add a new element to the collection of OPTION elementsfor this SELECT.
voidblur()
Removes keyboard focus from this element.
voidfocus()
Gives keyboard focus to this element.
booleangetDisabled()
The control is unavailable in this context.
HTMLFormElementgetForm()
Returns the FORM element containing this control.Returns null if this control is not within the context of a form.
intgetLength()
The number of options in this SELECT.
booleangetMultiple()
If true, multiple OPTION elements may be selected in this SELECT.
StringgetName()
Form control or object name when submitted with a form.
HTMLCollectiongetOptions()
The collection of OPTION elements contained by this element.
intgetSelectedIndex()
The ordinal index of the selected option.
intgetSize()
Number of visible rows.
intgetTabIndex()
Index that represents the element's position in the tabbing order.
StringgetType()
The type of control created.
StringgetValue()
The current form control value.
voidremove(int index)
Remove an element from the collection of OPTION elementsfor this SELECT.
voidsetDisabled(boolean disabled)
voidsetMultiple(boolean multiple)
voidsetName(String name)
voidsetSelectedIndex(int selectedIndex)
voidsetSize(int size)
voidsetTabIndex(int tabIndex)
voidsetValue(String value)

Method Detail

add

public void add(HTMLElement element, HTMLElement before)
Add a new element to the collection of OPTION elementsfor this SELECT.

Parameters: element The element to add. before The element to insert before, or NULL for the head of the list.

blur

public void blur()
Removes keyboard focus from this element.

focus

public void focus()
Gives keyboard focus to this element.

getDisabled

public boolean getDisabled()
The control is unavailable in this context. See the disabled attribute definition in HTML 4.0.

getForm

public HTMLFormElement getForm()
Returns the FORM element containing this control.Returns null if this control is not within the context of a form.

getLength

public int getLength()
The number of options in this SELECT.

getMultiple

public boolean getMultiple()
If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.0.

getName

public String getName()
Form control or object name when submitted with a form. See the name attribute definition in HTML 4.0.

getOptions

public HTMLCollection getOptions()
The collection of OPTION elements contained by this element.

getSelectedIndex

public int getSelectedIndex()
The ordinal index of the selected option. The value -1 is returned ifno element is selected. If multiple options are selected, the index ofthe first selected option is returned.

getSize

public int getSize()
Number of visible rows. See the size attribute definition in HTML 4.0.

getTabIndex

public int getTabIndex()
Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.0.

getType

public String getType()
The type of control created.

getValue

public String getValue()
The current form control value.

remove

public void remove(int index)
Remove an element from the collection of OPTION elementsfor this SELECT. Does nothing if no element has the givenindex.

Parameters: index The index of the item to remove.

setDisabled

public void setDisabled(boolean disabled)

setMultiple

public void setMultiple(boolean multiple)

setName

public void setName(String name)

setSelectedIndex

public void setSelectedIndex(int selectedIndex)

setSize

public void setSize(int size)

setTabIndex

public void setTabIndex(int tabIndex)

setValue

public void setValue(String value)