class HTMLSelectElement

The select element allows the selection of an option. More...

List of all Methods
Full name	`DOM::HTMLSelectElement`
Definition	`#include <html_form.h>`
Inherits	DOM::HTMLElement


	Annotated List
	Files
	Globals
	Hierarchy
	Index

Public Methods

HTMLSelectElement ()
HTMLSelectElement (const HTMLSelectElement &other)
HTMLSelectElement (const Node &other) : HTMLElement()
HTMLSelectElement & operator = (const HTMLSelectElement &other)
HTMLSelectElement & operator = (const Node &other)
~ HTMLSelectElement ()
DOMString type () const
long selectedIndex () const
void setSelectedIndex ( long )
DOMString value () const
void setValue ( const DOMString & )
long length () const
HTMLFormElement form () const
HTMLCollection options () const
bool disabled () const
void setDisabled ( bool )
bool multiple () const
void setMultiple ( bool )
DOMString name () const
void setName ( const DOMString & )
long size () const
void setSize ( long )
long tabIndex () const
void setTabIndex ( long )
void add ( const HTMLElement &element, const HTMLElement &before )
void remove ( long index )
void blur ( )
void focus ( )

Protected Methods

HTMLSelectElement (HTMLSelectElementImpl *impl)

Detailed Description

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 <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#edef-SELECT"> SELECT element definition </a> in HTML 4.0.

DOMString type ()

[const]

The type of control created.

long selectedIndex ()

[const]

The ordinal index of the selected option. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.

void setSelectedIndex ( long )

see selectedIndex

DOMString value ()

[const]

The current form control value.

void setValue ( const DOMString & )

see value

long length ()

[const]

The number of options in this <code> SELECT </code> .

HTMLFormElement form ()

[const]

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

HTMLCollection options ()

[const]

The collection of <code> OPTION </code> elements contained by this element.

bool disabled ()

[const]

The control is unavailable in this context. See the <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-disabled"> disabled attribute definition </a> in HTML 4.0.

void setDisabled ( bool )

see disabled

bool multiple ()

[const]

If true, multiple <code> OPTION </code> elements may be selected in this <code> SELECT </code> . See the <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-multiple"> multiple attribute definition </a> in HTML 4.0.

void setMultiple ( bool )

see multiple

DOMString name ()

[const]

Form control or object name when submitted with a form. See the <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-name-SELECT"> name attribute definition </a> in HTML 4.0.

void setName ( const DOMString & )

see name

long size ()

[const]

Number of visible rows. See the <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-size-SELECT"> size attribute definition </a> in HTML 4.0.

void setSize ( long )

see size

long tabIndex ()

[const]

Index that represents the element's position in the tabbing order. See the <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-tabindex"> tabindex attribute definition </a> in HTML 4.0.

void setTabIndex ( long )

see tabIndex

void add ( const HTMLElement &element, const HTMLElement &before )

Add a new element to the collection of <code> OPTION </code> elements for this <code> SELECT </code> .

Parameters:

element The element to add.

before The element to insert before, or 0 for the tail of the list.

void remove ( long index )

Remove an element from the collection of <code> OPTION </code> elements for this <code> SELECT </code> . Does nothing if no element has the given index.

Parameters:

index The index of the item to remove.

void blur ( )

Removes keyboard focus from this element.

void focus ( )

Gives keyboard focus to this element.

Generated by: ssk@tauon.ph.unimelb.EDU.AU on Wed May 23 05:55:52 2001, using kdoc 2.0a35.

element	The element to add.
before	The element to insert before, or 0 for the tail of the list.