khtml Library API Documentation

DOM::HTMLSelectElement Class Reference

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

#include <html_form.h>

Inheritance diagram for DOM::HTMLSelectElement:

DOM::HTMLElement DOM::Element DOM::Node List of all members.

Public Methods

HTMLSelectElement & operator= (const Node &other)
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 ()

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 SELECT element definition in HTML 4.0.

Definition at line 811 of file html_form.h.


Member Function Documentation

DOMString HTMLSelectElement::type  
 

The type of control created.

Definition at line 753 of file html_form.cpp.

long HTMLSelectElement::selectedIndex  
 

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.

Definition at line 759 of file html_form.cpp.

void HTMLSelectElement::setSelectedIndex long   
 

see selectedIndex

Definition at line 765 of file html_form.cpp.

DOMString HTMLSelectElement::value  
 

The current form control value.

Definition at line 771 of file html_form.cpp.

Referenced by setSize().

void HTMLSelectElement::setValue const DOMString  
 

see value

Definition at line 777 of file html_form.cpp.

References DOM::DOMString::implementation(), and DOM::DOMString::isNull().

long HTMLSelectElement::length  
 

The number of options in this SELECT .

Definition at line 783 of file html_form.cpp.

HTMLFormElement HTMLSelectElement::form  
 

### KDE 4.0: remove.

Reimplemented from DOM::Element.

Definition at line 789 of file html_form.cpp.

HTMLCollection HTMLSelectElement::options  
 

The collection of OPTION elements contained by this element.

Definition at line 794 of file html_form.cpp.

bool HTMLSelectElement::disabled  
 

The control is unavailable in this context.

See the disabled attribute definition in HTML 4.0.

Definition at line 800 of file html_form.cpp.

void HTMLSelectElement::setDisabled bool   
 

see disabled

Definition at line 806 of file html_form.cpp.

bool HTMLSelectElement::multiple  
 

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

See the multiple attribute definition in HTML 4.0.

Definition at line 812 of file html_form.cpp.

void HTMLSelectElement::setMultiple bool   
 

see multiple

Definition at line 818 of file html_form.cpp.

DOMString HTMLSelectElement::name  
 

Form control or object name when submitted with a form.

See the name attribute definition in HTML 4.0.

Definition at line 823 of file html_form.cpp.

void HTMLSelectElement::setName const DOMString  
 

see name

Definition at line 829 of file html_form.cpp.

long HTMLSelectElement::size  
 

Number of visible rows.

See the size attribute definition in HTML 4.0.

Definition at line 834 of file html_form.cpp.

void HTMLSelectElement::setSize long   
 

see size

Definition at line 840 of file html_form.cpp.

References QString::number(), and value().

long HTMLSelectElement::tabIndex  
 

Index that represents the element's position in the tabbing order.

See the tabindex attribute definition in HTML 4.0.

Definition at line 849 of file html_form.cpp.

void HTMLSelectElement::setTabIndex long   
 

see tabIndex

Definition at line 855 of file html_form.cpp.

void HTMLSelectElement::add const HTMLElement   element,
const HTMLElement   before
 

Add a new element to the collection of OPTION elements for this SELECT .

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

Definition at line 861 of file html_form.cpp.

void HTMLSelectElement::remove long    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.

Definition at line 872 of file html_form.cpp.

void HTMLSelectElement::blur  
 

Removes keyboard focus from this element.

Definition at line 877 of file html_form.cpp.

void HTMLSelectElement::focus  
 

Gives keyboard focus to this element.

Definition at line 883 of file html_form.cpp.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for khtml Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Apr 22 14:26:13 2004 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2003