File Doc Category Size Date Package
HTMLSelectElement.java API Doc Java SE 5 API 4602 Fri Aug 26 14:58:40 BST 2005 org.w3c.dom.html

HTMLSelectElement

public interface HTMLSelectElement implements HTMLElement

The select element allows the selection of an option. The contained options can be directly accessed through the select element as a collection. See the SELECT element definition in HTML 4.0.

Fields Summary
Constructors Summary
Methods Summary
public void add(org.w3c.dom.html.HTMLElement element, org.w3c.dom.html.HTMLElement before)
Add a new element to the collection of OPTION elements for this SELECT . This method is the equivalent of the appendChild method of the Node interface if the before parameter is null . It is equivalent to the insertBefore method on the parent of before in all other cases.
param
element The element to add.
param
before The element to insert before, or null for the tail of the list.
exception
DOMException NOT_FOUND_ERR: Raised if before is not a descendant of the SELECT element.
public void blur()
Removes keyboard focus from this element.
public void focus()
Gives keyboard focus to this element.
public boolean getDisabled()
The control is unavailable in this context. See the disabled attribute definition in HTML 4.0.
public org.w3c.dom.html.HTMLFormElement getForm()
Returns the FORM element containing this control. Returns null if this control is not within the context of a form.
public int getLength()
The number of options in this SELECT .
public boolean getMultiple()
If true, multiple OPTION elements may be selected in this SELECT . See the multiple attribute definition in HTML 4.0.
public java.lang.String getName()
Form control or object name when submitted with a form. See the name attribute definition in HTML 4.0.
public org.w3c.dom.html.HTMLCollection getOptions()
The collection of OPTION elements contained by this element.
public int getSelectedIndex()
The ordinal index of the selected option, starting from 0. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.
public int getSize()
Number of visible rows. See the size attribute definition in HTML 4.0.
public int getTabIndex()
Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.0.
public java.lang.String getType()
The type of this form control. This is the string "select-multiple" when the multiple attribute is true and the string "select-one" when false .
public java.lang.String getValue()
The current form control value.
public void remove(int index)
Remove an element from the collection of OPTION elements for this SELECT . Does nothing if no element has the given index.
param
index The index of the item to remove, starting from 0.
public void setDisabled(boolean disabled)
public void setMultiple(boolean multiple)
public void setName(java.lang.String name)
public void setSelectedIndex(int selectedIndex)
public void setSize(int size)
public void setTabIndex(int tabIndex)
public void setValue(java.lang.String value)