org.w3c.dom.html
Interface HTMLSelectElement

All Superinterfaces:
Element, HTMLElement, Node

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.


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

public java.lang.String getType()
The type of control created.

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.

setSelectedIndex

public void setSelectedIndex(int selectedIndex)

getValue

public java.lang.String getValue()
The current form control value.

setValue

public void setValue(java.lang.String value)

getLength

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

getForm

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

getOptions

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

getDisabled

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

setDisabled

public void setDisabled(boolean disabled)

getMultiple

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

setMultiple

public void setMultiple(boolean multiple)

getName

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

setName

public void setName(java.lang.String name)

getSize

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

setSize

public void setSize(int size)

getTabIndex

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

setTabIndex

public void setTabIndex(int tabIndex)

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.

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.

blur

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

focus

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


Copyright © 1999-2005 Apache XML Project. All Rights Reserved.