.TH "DOM::HTMLSelectElement" 3 "28 Jan 2004" "khtml Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
DOM::HTMLSelectElement \- The select element allows the selection of an option.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <html_form.h>\fP
.PP
Inherits \fBDOM::HTMLElement\fP.
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBHTMLSelectElement\fP (const  \fBHTMLSelectElement\fP &other)"
.br
.ti -1c
.RI "\fBHTMLSelectElement\fP (const  \fBNode\fP &other)"
.br
.ti -1c
.RI "\fBHTMLSelectElement\fP & \fBoperator=\fP (const  \fBHTMLSelectElement\fP &other)"
.br
.ti -1c
.RI "\fBHTMLSelectElement\fP & \fBoperator=\fP (const  \fBNode\fP &other)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBtype\fP () const "
.br
.RI "\fIThe type of control created. \fP"
.ti -1c
.RI "long \fBselectedIndex\fP () const "
.br
.RI "\fIThe ordinal index of the selected option. \fP"
.ti -1c
.RI "void \fBsetSelectedIndex\fP (long)"
.br
.RI "\fIsee \fBselectedIndex\fP \fP"
.ti -1c
.RI "\fBDOMString\fP \fBvalue\fP () const "
.br
.RI "\fIThe current form control value. \fP"
.ti -1c
.RI "void \fBsetValue\fP (const  \fBDOMString\fP &)"
.br
.RI "\fIsee \fBvalue\fP \fP"
.ti -1c
.RI "long \fBlength\fP () const "
.br
.RI "\fIThe number of options in this \fC SELECT \fP . \fP"
.ti -1c
.RI "\fBHTMLFormElement\fP \fBform\fP () const "
.br
.RI "\fI\fBThis class or method is obsolete, it is provided for compatibility only.\fP. \fP"
.ti -1c
.RI "\fBHTMLCollection\fP \fBoptions\fP () const "
.br
.RI "\fIThe collection of \fC OPTION \fP elements contained by this element. \fP"
.ti -1c
.RI "bool \fBdisabled\fP () const "
.br
.RI "\fIThe control is unavailable in this context. \fP"
.ti -1c
.RI "void \fBsetDisabled\fP (bool)"
.br
.RI "\fIsee \fBdisabled\fP \fP"
.ti -1c
.RI "bool \fBmultiple\fP () const "
.br
.RI "\fIIf true, multiple \fC OPTION \fP elements may be selected in this \fC SELECT \fP . \fP"
.ti -1c
.RI "void \fBsetMultiple\fP (bool)"
.br
.RI "\fIsee \fBmultiple\fP \fP"
.ti -1c
.RI "\fBDOMString\fP \fBname\fP () const "
.br
.RI "\fIForm control or object name when submitted with a form. \fP"
.ti -1c
.RI "void \fBsetName\fP (const  \fBDOMString\fP &)"
.br
.RI "\fIsee \fBname\fP \fP"
.ti -1c
.RI "long \fBsize\fP () const "
.br
.RI "\fINumber of visible rows. \fP"
.ti -1c
.RI "void \fBsetSize\fP (long)"
.br
.RI "\fIsee \fBsize\fP \fP"
.ti -1c
.RI "long \fBtabIndex\fP () const "
.br
.RI "\fIIndex that represents the element's position in the tabbing order. \fP"
.ti -1c
.RI "void \fBsetTabIndex\fP (long)"
.br
.RI "\fIsee \fBtabIndex\fP \fP"
.ti -1c
.RI "void \fBadd\fP (const  \fBHTMLElement\fP &element, const  \fBHTMLElement\fP &before)"
.br
.RI "\fIAdd a new element to the collection of \fC OPTION \fP elements for this \fC SELECT \fP . \fP"
.ti -1c
.RI "void \fBremove\fP (long index)"
.br
.RI "\fIRemove an element from the collection of \fC OPTION \fP elements for this \fC SELECT \fP . \fP"
.ti -1c
.RI "void \fBblur\fP ()"
.br
.RI "\fIRemoves keyboard focus from this element. \fP"
.ti -1c
.RI "void \fBfocus\fP ()"
.br
.RI "\fIGives keyboard focus to this element. \fP"
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBHTMLSelectElement\fP (HTMLSelectElementImpl *impl)"
.br
.in -1c
.SH "Detailed Description"
.PP 
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 \fCSELECT element definition \fP in HTML 4.0. 
.PP
Definition at line 809 of file html_form.h.
.SH "Member Function Documentation"
.PP 
.SS "\fBDOMString\fP HTMLSelectElement::type () const"
.PP
The type of control created. Definition at line 758 of file html_form.cpp.
.SS "long HTMLSelectElement::selectedIndex () const"
.PP
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 764 of file html_form.cpp.
.SS "void HTMLSelectElement::setSelectedIndex (long)"
.PP
see \fBselectedIndex\fP Definition at line 770 of file html_form.cpp.
.SS "\fBDOMString\fP HTMLSelectElement::value () const"
.PP
The current form control value. Definition at line 776 of file html_form.cpp.
.PP
Referenced by setSize().
.SS "void HTMLSelectElement::setValue (const \fBDOMString\fP &)"
.PP
see \fBvalue\fP Definition at line 782 of file html_form.cpp.
.PP
References DOM::DOMString::implementation(), and DOM::DOMString::isNull().
.SS "long HTMLSelectElement::length () const"
.PP
The number of options in this \fC SELECT \fP . Definition at line 788 of file html_form.cpp.
.SS "\fBHTMLFormElement\fP HTMLSelectElement::form () const"
.PP
\fBThis class or method is obsolete, it is provided for compatibility only.\fP. ### \fBKDE\fP 4.0: remove. Reimplemented from \fBDOM::Element\fP.
.PP
Definition at line 794 of file html_form.cpp.
.SS "\fBHTMLCollection\fP HTMLSelectElement::options () const"
.PP
The collection of \fC OPTION \fP elements contained by this element. Definition at line 799 of file html_form.cpp.
.SS "bool HTMLSelectElement::disabled () const"
.PP
The control is unavailable in this context. See the \fCdisabled attribute definition \fP in HTML 4.0. Definition at line 805 of file html_form.cpp.
.SS "void HTMLSelectElement::setDisabled (bool)"
.PP
see \fBdisabled\fP Definition at line 811 of file html_form.cpp.
.SS "bool HTMLSelectElement::multiple () const"
.PP
If true, multiple \fC OPTION \fP elements may be selected in this \fC SELECT \fP . See the \fCmultiple attribute definition \fP in HTML 4.0. Definition at line 817 of file html_form.cpp.
.SS "void HTMLSelectElement::setMultiple (bool)"
.PP
see \fBmultiple\fP Definition at line 823 of file html_form.cpp.
.SS "\fBDOMString\fP HTMLSelectElement::name () const"
.PP
Form control or object name when submitted with a form. See the \fCname attribute definition \fP in HTML 4.0. Definition at line 828 of file html_form.cpp.
.SS "void HTMLSelectElement::setName (const \fBDOMString\fP &)"
.PP
see \fBname\fP Definition at line 834 of file html_form.cpp.
.SS "long HTMLSelectElement::size () const"
.PP
Number of visible rows. See the \fCsize attribute definition \fP in HTML 4.0. Definition at line 839 of file html_form.cpp.
.SS "void HTMLSelectElement::setSize (long)"
.PP
see \fBsize\fP Definition at line 845 of file html_form.cpp.
.PP
References QString::number(), and value().
.SS "long HTMLSelectElement::tabIndex () const"
.PP
Index that represents the element's position in the tabbing order. See the \fCtabindex attribute definition \fP in HTML 4.0. Definition at line 854 of file html_form.cpp.
.SS "void HTMLSelectElement::setTabIndex (long)"
.PP
see \fBtabIndex\fP Definition at line 860 of file html_form.cpp.
.SS "void HTMLSelectElement::add (const \fBHTMLElement\fP & element, const \fBHTMLElement\fP & before)"
.PP
Add a new element to the collection of \fC OPTION \fP elements for this \fC SELECT \fP . \fBParameters:\fP
.RS 4
\fIelement\fP The element to add.
.br
\fIbefore\fP The element to insert before, or 0 for the tail of the list. 
.RE
.PP
Definition at line 866 of file html_form.cpp.
.SS "void HTMLSelectElement::remove (long index)"
.PP
Remove an element from the collection of \fC OPTION \fP elements for this \fC SELECT \fP . Does nothing if no element has the given index.
.PP
\fBParameters:\fP
.RS 4
\fIindex\fP The index of the item to remove. 
.RE
.PP
Definition at line 877 of file html_form.cpp.
.SS "void HTMLSelectElement::blur ()"
.PP
Removes keyboard focus from this element. Definition at line 882 of file html_form.cpp.
.SS "void HTMLSelectElement::focus ()"
.PP
Gives keyboard focus to this element. Definition at line 888 of file html_form.cpp.

.SH "Author"
.PP 
Generated automatically by Doxygen for khtml Library from the source code.
