org.w3c.dom.html
Interface HTMLSelectElement

All Superinterfaces:

Element, HTMLElement, Node

All Known Implementing Classes:

HTMLSelectElementImpl

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.

Field Summary

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Method Summary

void	add(HTMLElement element, HTMLElement before) Add a new element to the collection of OPTION elementsfor this SELECT.
void	blur() Removes keyboard focus from this element.
void	focus() Gives keyboard focus to this element.
boolean	getDisabled() The control is unavailable in this context.
HTMLFormElement	getForm() Returns the FORM element containing this control.Returns null if this control is not within the context of a form.
int	getLength() The number of options in this SELECT.
boolean	getMultiple() If true, multiple OPTION elements may be selected in this SELECT.
java.lang.String	getName() Form control or object name when submitted with a form.
HTMLCollection	getOptions() The collection of OPTION elements contained by this element.
int	getSelectedIndex() The ordinal index of the selected option.
int	getSize() Number of visible rows.
int	getTabIndex() Index that represents the element's position in the tabbing order.
java.lang.String	getType() The type of control created.
java.lang.String	getValue() The current form control value.
void	remove(int index) Remove an element from the collection of OPTION elementsfor this SELECT.
void	setDisabled(boolean disabled)
void	setMultiple(boolean multiple)
void	setName(java.lang.String name)
void	setSelectedIndex(int selectedIndex)
void	setSize(int size)
void	setTabIndex(int tabIndex)
void	setValue(java.lang.String value)

Methods inherited from interface org.w3c.dom.html.HTMLElement

getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle

Methods inherited from interface org.w3c.dom.Element

getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS

Methods inherited from interface org.w3c.dom.Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Method Detail

getType

java.lang.String getType()

The type of control created.

getSelectedIndex

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.

setSelectedIndex

void setSelectedIndex(int selectedIndex)

getValue

java.lang.String getValue()

The current form control value.

setValue

void setValue(java.lang.String value)

getLength

int getLength()

The number of options in this SELECT.

getForm

HTMLFormElement getForm()

Returns the FORM element containing this control.Returns null if this control is not within the context of a form.

getOptions

HTMLCollection getOptions()

The collection of OPTION elements contained by this element.

getDisabled

boolean getDisabled()

The control is unavailable in this context. See the disabled attribute definition in HTML 4.0.

setDisabled

void setDisabled(boolean disabled)

getMultiple

boolean getMultiple()

If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.0.

setMultiple

void setMultiple(boolean multiple)

getName

java.lang.String getName()

Form control or object name when submitted with a form. See the name attribute definition in HTML 4.0.

setName

void setName(java.lang.String name)

getSize

int getSize()

Number of visible rows. See the size attribute definition in HTML 4.0.

setSize

void setSize(int size)

getTabIndex

int getTabIndex()

Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.0.

setTabIndex

void setTabIndex(int tabIndex)

add

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.

remove

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.

blur

void blur()

Removes keyboard focus from this element.

focus

void focus()

Gives keyboard focus to this element.