Summary: Inherited Constants | Protected Ctors | Methods | Inherited Methods | [Expand All]

public class

SelectElement

extends Element

java.lang.Object
↳	com.google.gwt.core.client.JavaScriptObject
	↳	com.google.gwt.dom.client.Node
		↳	com.google.gwt.dom.client.Element
			↳	com.google.gwt.dom.client.SelectElement

Class Overview

The select element allows the selection of an option. The contained options can be directly accessed through the select element as a collection.

Summary

[Expand]

Inherited Constants

From class com.google.gwt.dom.client.Node

Protected Constructors
	SelectElement()

Public Methods
final void	add(OptionElement option, OptionElement before) Add a new element to the collection of OPTION elements for this SELECT.
static SelectElement	as(Element elem) Assert that the given `Element` is compatible with this class and automatically typecast it.
final void	clear() Removes all OPTION elements from this SELECT.
final String	getDisabled() This method is deprecated. use `isDisabled()` instead.
final FormElement	getForm() Returns the FORM element containing this control.
final int	getLength() The number of options in this SELECT.
final String	getMultiple() If true, multiple OPTION elements may be selected in this SELECT.
final String	getName() Form control or object name when submitted with a form.
final NodeList<OptionElement>	getOptions() The collection of OPTION elements contained by this element.
final int	getSelectedIndex() The ordinal index of the selected option, starting from 0.
final int	getSize() Number of visible rows.
final String	getType() The type of this form control.
final 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.
final boolean	isDisabled() The control is unavailable in this context.
final boolean	isMultiple() If true, multiple OPTION elements may be selected in this SELECT.
final void	remove(int index) Remove an element from the collection of OPTION elements for this SELECT.
final void	setDisabled(String disabled) The control is unavailable in this context.
final void	setDisabled(boolean disabled) The control is unavailable in this context.
final void	setMultiple(boolean multiple) If true, multiple OPTION elements may be selected in this SELECT.
final void	setName(String name) Form control or object name when submitted with a form.
final void	setSelectedIndex(int index) The ordinal index of the selected option, starting from 0.
final void	setSize(int size) Number of visible rows.
final void	setType(String type) The type of this form control.
final 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.

[Expand]

Inherited Methods

From class com.google.gwt.dom.client.Element

final void	addClassName(String className) Adds a name to this element's class property.
static Element	as(JavaScriptObject o) Assert that the given `Node` is an `Element` and automatically typecast it.
static Element	as(Node node) Assert that the given `Node` is an `Element` and automatically typecast it.
final void	blur() Removes keyboard focus from this element.
final void	dispatchEvent(NativeEvent evt) Dispatched the given event with this element as its target.
final void	focus() Gives keyboard focus to this element.
final int	getAbsoluteBottom() Gets an element's absolute bottom coordinate in the document's coordinate system.
final int	getAbsoluteLeft() Gets an element's absolute left coordinate in the document's coordinate system.
final int	getAbsoluteRight() Gets an element's absolute right coordinate in the document's coordinate system.
final int	getAbsoluteTop() Gets an element's absolute top coordinate in the document's coordinate system.
final String	getAttribute(String name) Retrieves an attribute value by name.
final String	getClassName() The class attribute of the element.
final int	getClientHeight() Returns the inner height of an element in pixels, including padding but not the horizontal scrollbar height, border, or margin.
final int	getClientWidth() Returns the inner width of an element in pixels, including padding but not the vertical scrollbar width, border, or margin.
final String	getDir() Specifies the base direction of directionally neutral text and the directionality of tables.
final NodeList<Element>	getElementsByTagName(String name) Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in a preorder traversal of this Element tree.
final Element	getFirstChildElement() The first child of element this element.
final String	getId() The element's identifier.
final String	getInnerHTML() All of the markup and content within a given element.
final String	getInnerText() The text between the start and end tags of the object.
final String	getLang() Language code defined in RFC 1766.
final Element	getNextSiblingElement() The element immediately following this element.
final int	getOffsetHeight() The height of an element relative to the layout.
final int	getOffsetLeft() The number of pixels that the upper left corner of the current element is offset to the left within the offsetParent node.
final Element	getOffsetParent() Returns a reference to the object which is the closest (nearest in the containment hierarchy) positioned containing element.
final int	getOffsetTop() The number of pixels that the upper top corner of the current element is offset to the top within the offsetParent node.
final int	getOffsetWidth() The width of an element relative to the layout.
final boolean	getPropertyBoolean(String name) Gets a boolean property from this element.
final double	getPropertyDouble(String name) Gets a double property from this element.
final int	getPropertyInt(String name) Gets an integer property from this element.
final JavaScriptObject	getPropertyJSO(String name) Gets a JSO property from this element.
final Object	getPropertyObject(String name) Gets an object property from this element.
final String	getPropertyString(String name) Gets a property from this element.
final int	getScrollHeight() The height of the scroll view of an element.
final int	getScrollLeft() The number of pixels that an element's content is scrolled from the left.
final int	getScrollTop() The number of pixels that an element's content is scrolled from the top.
final int	getScrollWidth() The width of the scroll view of an element.
final String	getString() Gets a string representation of this element (as outer HTML).
final Style	getStyle() Gets this element's `Style` object.
final int	getTabIndex() The index that represents the element's position in the tabbing order.
final String	getTagName() Gets the element's full tag name, including the namespace-prefix if present.
final String	getTitle() The element's advisory title.
final boolean	hasAttribute(String name) Determines whether an element has an attribute with a given name.
final boolean	hasTagName(String tagName) Determines whether this element has the given tag name.
static boolean	is(Node node) Determine whether the given `Node` can be cast to an `Element`.
static boolean	is(JavaScriptObject o) Determines whether the given `JavaScriptObject` can be cast to an `Element`.
final void	removeAttribute(String name) Removes an attribute by name.
final void	removeClassName(String className) Removes a name from this element's class property.
final void	replaceClassName(String oldClassName, String newClassName) Replace one class name with another.
final void	scrollIntoView() Scrolls this element into view.
final void	setAttribute(String name, String value) Adds a new attribute.
final void	setClassName(String className) The class attribute of the element.
final void	setDir(String dir) Specifies the base direction of directionally neutral text and the directionality of tables.
final void	setId(String id) The element's identifier.
final void	setInnerHTML(String html) All of the markup and content within a given element.
final void	setInnerText(String text) The text between the start and end tags of the object.
final void	setLang(String lang) Language code defined in RFC 1766.
final void	setPropertyBoolean(String name, boolean value) Sets a boolean property on this element.
final void	setPropertyDouble(String name, double value) Sets a double property on this element.
final void	setPropertyInt(String name, int value) Sets an integer property on this element.
final void	setPropertyJSO(String name, JavaScriptObject value) Sets a JSO property on this element.
final void	setPropertyObject(String name, Object value) Sets an object property on this element.
final void	setPropertyString(String name, String value) Sets a property on this element.
final void	setScrollLeft(int scrollLeft) The number of pixels that an element's content is scrolled to the left.
final void	setScrollTop(int scrollTop) The number of pixels that an element's content is scrolled to the top.
final void	setTabIndex(int tabIndex) The index that represents the element's position in the tabbing order.
final void	setTitle(String title) The element's advisory title.

From class com.google.gwt.dom.client.Node

final <T extends Node> T	appendChild(T newChild) Adds the node newChild to the end of the list of children of this node.
static Node	as(JavaScriptObject o) Assert that the given `JavaScriptObject` is a DOM node and automatically typecast it.
final Node	cloneNode(boolean deep) Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes.
final Node	getChild(int index) Gets the child node at the given index.
final int	getChildCount() Gets the number of child nodes contained within this node.
final NodeList<Node>	getChildNodes() A NodeList that contains all children of this node.
final Node	getFirstChild() The first child of this node.
final Node	getLastChild() The last child of this node.
final Node	getNextSibling() The node immediately following this node.
final String	getNodeName() The name of this node, depending on its type; see the table above.
final short	getNodeType() A code representing the type of the underlying object, as defined above.
final String	getNodeValue() The value of this node, depending on its type; see the table above.
final Document	getOwnerDocument() The Document object associated with this node.
final Element	getParentElement() Gets the parent element of this node.
final Node	getParentNode() The parent of this node.
final Node	getPreviousSibling() The node immediately preceding this node.
final boolean	hasChildNodes() Returns whether this node has any children.
final boolean	hasParentElement() Determines whether this node has a parent element.
final Node	insertAfter(Node newChild, Node refChild) Inserts the node newChild after the existing child node refChild.
final Node	insertBefore(Node newChild, Node refChild) Inserts the node newChild before the existing child node refChild.
final Node	insertFirst(Node child) Inserts the given child as the first child of this node.
static boolean	is(JavaScriptObject o) Determines whether the given `JavaScriptObject` is a DOM node.
final boolean	isOrHasChild(Node child) Determine whether a node is equal to, or the child of, this node.
final Node	removeChild(Node oldChild) Removes the child node indicated by oldChild from the list of children, and returns it.
final void	removeFromParent() Removes this node from its parent node if it is attached to one.
final Node	replaceChild(Node newChild, Node oldChild) Replaces the child node oldChild with newChild in the list of children, and returns the oldChild node.
final void	setNodeValue(String nodeValue) The value of this node, depending on its type; see the table above.

From class com.google.gwt.core.client.JavaScriptObject

From class java.lang.Object

Protected Constructors

protected SelectElement ()

Public Methods

public final void add (OptionElement option, OptionElement 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.

Parameters

option	The element to add
before	The element to insert before, or null for the tail of the list

public static SelectElement as (Element elem)

Assert that the given Element is compatible with this class and automatically typecast it.

public final void clear ()

Removes all OPTION elements from this SELECT.

public final String getDisabled ()

This method is deprecated.
use isDisabled() instead.

The control is unavailable in this context.

public final FormElement getForm ()

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

public final int getLength ()

The number of options in this SELECT.

public final String getMultiple ()

If true, multiple OPTION elements may be selected in this SELECT.

public final String getName ()

Form control or object name when submitted with a form.

public final NodeList<OptionElement> getOptions ()

The collection of OPTION elements contained by this element.

public final 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 final int getSize ()

Number of visible rows.

public final 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 final 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.

public final boolean isDisabled ()

The control is unavailable in this context.

public final boolean isMultiple ()

If true, multiple OPTION elements may be selected in this SELECT.

public final 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.

Parameters

index	The index of the item to remove, starting from 0.

public final void setDisabled (String disabled)

The control is unavailable in this context.

public final void setDisabled (boolean disabled)

The control is unavailable in this context.

public final void setMultiple (boolean multiple)

If true, multiple OPTION elements may be selected in this SELECT.

public final void setName (String name)

Form control or object name when submitted with a form.

public final void setSelectedIndex (int index)

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 final void setSize (int size)

Number of visible rows.

public final void setType (String type)

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 final 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.

Interfaces

Classes

Annotations

Enums

SelectElement

Class Overview

See Also

Summary

Protected Constructors

protected SelectElement ()

Public Methods

public final void add (OptionElement option, OptionElement before)

Parameters

public static SelectElement as (Element elem)

public final void clear ()

public final String getDisabled ()

See Also

public final FormElement getForm ()

public final int getLength ()

public final String getMultiple ()

See Also

public final String getName ()

See Also

public final NodeList<OptionElement> getOptions ()

public final int getSelectedIndex ()

public final int getSize ()

See Also

public final String getType ()

public final String getValue ()

public final boolean isDisabled ()

See Also

public final boolean isMultiple ()

See Also

public final void remove (int index)

Parameters

public final void setDisabled (String disabled)

See Also

public final void setDisabled (boolean disabled)

See Also

public final void setMultiple (boolean multiple)

See Also

public final void setName (String name)

See Also

public final void setSelectedIndex (int index)

public final void setSize (int size)

See Also

public final void setType (String type)

public final void setValue (String value)