gnu.xml.dom.html2

Class DomHTMLSelectElement

Implemented Interfaces:
Cloneable, Comparable<T>, DocumentEvent, Element, EventTarget, HTMLElement, HTMLSelectElement, Node, NodeList

public class DomHTMLSelectElement
extends DomHTMLElement
implements HTMLSelectElement

An HTML 'SELECT' element node.

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

Constructor Summary

DomHTMLSelectElement(DomHTMLDocument owner, String namespaceURI, String name)

Method Summary

void
add(HTMLElement element, HTMLElement before)
Add a new element to the collection of OPTION elements for 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.
int
getLength()
The number of options in this SELECT.
boolean
getMultiple()
If true, multiple OPTION elements may be selected in this SELECT.
String
getName()
Form control or object name when submitted with a form.
HTMLOptionsCollection
getOptions()
The collection of OPTION elements contained by this element.
int
getSelectedIndex()
The ordinal index of the selected option, starting from 0.
int
getSize()
Number of visible rows.
int
getTabIndex()
Index that represents the element's position in the tabbing order.
String
getType()
The type of this form control.
String
getValue()
The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.
void
remove(int index)
Remove an element from the collection of OPTION elements for this SELECT.
void
setDisabled(boolean disabled)
The control is unavailable in this context.
void
setLength(int length)
The number of options in this SELECT.
void
setMultiple(boolean multiple)
If true, multiple OPTION elements may be selected in this SELECT.
void
setName(String name)
Form control or object name when submitted with a form.
void
setSelectedIndex(int selectedIndex)
The ordinal index of the selected option, starting from 0.
void
setSize(int size)
Number of visible rows.
void
setTabIndex(int tabIndex)
Index that represents the element's position in the tabbing order.
void
setValue(String value)
The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.

Methods inherited from class gnu.xml.dom.html2.DomHTMLElement

dispatchUIEvent, getBooleanHTMLAttribute, getChildElement, getClassName, getDir, getHTMLAttribute, getId, getIndex, getIntHTMLAttribute, getLang, getParentElement, getTitle, setBooleanHTMLAttribute, setClassName, setDir, setHTMLAttribute, setId, setIntHTMLAttribute, setLang, setTitle

Methods inherited from class gnu.xml.dom.DomElement

clone, getAttribute, getAttributeNS, getAttributeNode, getAttributeNodeNS, getAttributes, getBaseURI, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isDefaultNamespace, isEqualNode, lookupNamespaceURI, lookupPrefix, makeReadonly, removeAttribute, removeAttributeNS, removeAttributeNode, setAttribute, setAttributeNS, setAttributeNode, setAttributeNodeNS, setIdAttribute, setIdAttributeNS, setIdAttributeNode

Methods inherited from class gnu.xml.dom.DomNsNode

getLocalName, getNamespaceURI, getNodeName, getPrefix, setPrefix

Methods inherited from class gnu.xml.dom.DomNode

addEventListener, appendChild, clone, cloneNode, compact, compareDocumentPosition, compareTo, createEvent, dispatchEvent, getAttributes, getBaseURI, getChildNodes, getElementsByTagName, getElementsByTagNameNS, getFeature, getFirstChild, getLastChild, getLength, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isReadonly, isSameNode, isSupported, item, list, lookupNamespaceURI, lookupPrefix, makeReadonly, nameAndTypeEquals, normalize, removeChild, removeEventListener, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData, toString, trimToSize

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DomHTMLSelectElement

protected DomHTMLSelectElement(DomHTMLDocument owner,
                               String namespaceURI,
                               String name)

Method Details

add

public void add(HTMLElement element,
                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. This method may have no effect if the new element is not an OPTION or an OPTGROUP.
Specified by:
add in interface HTMLSelectElement
Parameters:
element - The element to add.
before - The element to insert before, or null for the tail of the list.
Throws:
DOMException - NOT_FOUND_ERR: Raised if before is not a descendant of the SELECT element.

blur

public void blur()
Removes keyboard focus from this element.
Specified by:
blur in interface HTMLSelectElement

focus

public void focus()
Gives keyboard focus to this element.
Specified by:
focus in interface HTMLSelectElement

getDisabled

public boolean getDisabled()
The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.
Specified by:
getDisabled in interface HTMLSelectElement

getForm

public HTMLFormElement getForm()
Returns the FORM element containing this control. Returns null if this control is not within the context of a form.
Specified by:
getForm in interface HTMLSelectElement

getLength

public int getLength()
The number of options in this SELECT.
Specified by:
getLength in interface HTMLSelectElement
getLength in interface NodeList
Overrides:
getLength in interface DomNode

getMultiple

public boolean getMultiple()
If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.01.
Specified by:
getMultiple in interface HTMLSelectElement

getName

public String getName()
Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01.
Specified by:
getName in interface HTMLSelectElement

getOptions

public HTMLOptionsCollection getOptions()
The collection of OPTION elements contained by this element.
Specified by:
getOptions in interface HTMLSelectElement

getSelectedIndex

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.
Specified by:
getSelectedIndex in interface HTMLSelectElement

getSize

public int getSize()
Number of visible rows. See the size attribute definition in HTML 4.01.
Specified by:
getSize in interface HTMLSelectElement

getTabIndex

public int getTabIndex()
Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01.
Specified by:
getTabIndex in interface HTMLSelectElement

getType

public 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.
Specified by:
getType in interface HTMLSelectElement

getValue

public String getValue()
The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.
Specified by:
getValue in interface HTMLSelectElement

remove

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.
Specified by:
remove in interface HTMLSelectElement
Parameters:
index - The index of the item to remove, starting from 0.

setDisabled

public void setDisabled(boolean disabled)
The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.
Specified by:
setDisabled in interface HTMLSelectElement

setLength

public void setLength(int length)
The number of options in this SELECT.
Specified by:
setLength in interface HTMLSelectElement
Throws:
DOMException - NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.

setMultiple

public void setMultiple(boolean multiple)
If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.01.
Specified by:
setMultiple in interface HTMLSelectElement

setName

public void setName(String name)
Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01.
Specified by:
setName in interface HTMLSelectElement

setSelectedIndex

public void setSelectedIndex(int selectedIndex)
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.
Specified by:
setSelectedIndex in interface HTMLSelectElement

setSize

public void setSize(int size)
Number of visible rows. See the size attribute definition in HTML 4.01.
Specified by:
setSize in interface HTMLSelectElement

setTabIndex

public void setTabIndex(int tabIndex)
Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01.
Specified by:
setTabIndex in interface HTMLSelectElement

setValue

public void setValue(String value)
The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.
Specified by:
setValue in interface HTMLSelectElement

DomHTMLSelectElement.java -- Copyright (C) 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.