\section{DOM::HTMLSelect\-Element Class Reference}
\label{classDOM_1_1HTMLSelectElement}\index{DOM::HTMLSelectElement@{DOM::HTMLSelectElement}}
The select element allows the selection of an option.  


{\tt \#include $<$html\_\-form.h$>$}

Inheritance diagram for DOM::HTMLSelect\-Element:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=86pt]{classDOM_1_1HTMLSelectElement__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for DOM::HTMLSelect\-Element:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=86pt]{classDOM_1_1HTMLSelectElement__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf HTMLSelect\-Element} (const {\bf HTMLSelect\-Element} \&other)\label{classDOM_1_1HTMLSelectElement_a1}

\item 
{\bf HTMLSelect\-Element} (const {\bf Node} \&other)\label{classDOM_1_1HTMLSelectElement_a2}

\item 
{\bf HTMLSelect\-Element} \& {\bf operator=} (const {\bf HTMLSelect\-Element} \&other)\label{classDOM_1_1HTMLSelectElement_a3}

\item 
{\bf HTMLSelect\-Element} \& {\bf operator=} (const {\bf Node} \&other)\label{classDOM_1_1HTMLSelectElement_a4}

\item 
{\bf DOMString} {\bf type} () const 
\item 
long {\bf selected\-Index} () const 
\item 
void {\bf set\-Selected\-Index} (long)
\item 
{\bf DOMString} {\bf value} () const 
\item 
void {\bf set\-Value} (const {\bf DOMString} \&)
\item 
long {\bf length} () const 
\item 
{\bf HTMLForm\-Element} {\bf form} () const 
\item 
{\bf HTMLCollection} {\bf options} () const 
\item 
bool {\bf disabled} () const 
\item 
void {\bf set\-Disabled} (bool)
\item 
bool {\bf multiple} () const 
\item 
void {\bf set\-Multiple} (bool)
\item 
{\bf DOMString} {\bf name} () const 
\item 
void {\bf set\-Name} (const {\bf DOMString} \&)
\item 
long {\bf size} () const 
\item 
void {\bf set\-Size} (long)
\item 
long {\bf tab\-Index} () const 
\item 
void {\bf set\-Tab\-Index} (long)
\item 
void {\bf add} (const {\bf HTMLElement} \&element, const {\bf HTMLElement} \&before)
\item 
void {\bf remove} (long index)
\item 
void {\bf blur} ()
\item 
void {\bf focus} ()
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
{\bf HTMLSelect\-Element} (HTMLSelect\-Element\-Impl $\ast$impl)\label{classDOM_1_1HTMLSelectElement_b0}

\end{CompactItemize}


\subsection{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 {\tt SELECT element definition } in HTML 4.0. 



Definition at line 810 of file html\_\-form.h.

\subsection{Member Function Documentation}
\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!type@{type}}
\index{type@{type}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf DOMString} HTMLSelect\-Element::type () const}\label{classDOM_1_1HTMLSelectElement_a6}


The type of control created. 



Definition at line 754 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!selectedIndex@{selectedIndex}}
\index{selectedIndex@{selectedIndex}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}long HTMLSelect\-Element::selected\-Index () const}\label{classDOM_1_1HTMLSelectElement_a7}


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 760 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setSelectedIndex@{setSelectedIndex}}
\index{setSelectedIndex@{setSelectedIndex}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Selected\-Index (long)}\label{classDOM_1_1HTMLSelectElement_a8}


see selected\-Index 



Definition at line 766 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!value@{value}}
\index{value@{value}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf DOMString} HTMLSelect\-Element::value () const}\label{classDOM_1_1HTMLSelectElement_a9}


The current form control value. 



Definition at line 772 of file html\_\-form.cpp.

Referenced by set\-Name(), set\-Size(), and set\-Value().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setValue@{setValue}}
\index{setValue@{setValue}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Value (const {\bf DOMString} \&)}\label{classDOM_1_1HTMLSelectElement_a10}


see value 



Definition at line 778 of file html\_\-form.cpp.

References DOM::DOMString::implementation(), DOM::DOMString::is\-Null(), and value().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!length@{length}}
\index{length@{length}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}long HTMLSelect\-Element::length () const}\label{classDOM_1_1HTMLSelectElement_a11}


The number of options in this {\tt SELECT} . 



Definition at line 784 of file html\_\-form.cpp.

References DOM::DOMString::length().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!form@{form}}
\index{form@{form}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf HTMLForm\-Element} HTMLSelect\-Element::form () const}\label{classDOM_1_1HTMLSelectElement_a12}


\#\#\# {\bf KDE} 4.0: remove. 



Reimplemented from {\bf DOM::Element} {\rm (p.\,\pageref{classDOM_1_1Element_a26})}.

Definition at line 790 of file html\_\-form.cpp.

References DOM::Element::form().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!options@{options}}
\index{options@{options}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf HTMLCollection} HTMLSelect\-Element::options () const}\label{classDOM_1_1HTMLSelectElement_a13}


The collection of {\tt OPTION} elements contained by this element. 



Definition at line 795 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!disabled@{disabled}}
\index{disabled@{disabled}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool HTMLSelect\-Element::disabled () const}\label{classDOM_1_1HTMLSelectElement_a14}


The control is unavailable in this context. 

See the {\tt disabled attribute definition } in HTML 4.0. 

Definition at line 801 of file html\_\-form.cpp.

References DOM::HTMLCollection::is\-Null().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setDisabled@{setDisabled}}
\index{setDisabled@{setDisabled}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Disabled (bool)}\label{classDOM_1_1HTMLSelectElement_a15}


see disabled 



Definition at line 807 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!multiple@{multiple}}
\index{multiple@{multiple}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool HTMLSelect\-Element::multiple () const}\label{classDOM_1_1HTMLSelectElement_a16}


If true, multiple {\tt OPTION} elements may be selected in this {\tt SELECT} . 

See the {\tt multiple attribute definition } in HTML 4.0. 

Definition at line 813 of file html\_\-form.cpp.

References DOM::HTMLCollection::is\-Null().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setMultiple@{setMultiple}}
\index{setMultiple@{setMultiple}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Multiple (bool)}\label{classDOM_1_1HTMLSelectElement_a17}


see multiple 



Definition at line 819 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!name@{name}}
\index{name@{name}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf DOMString} HTMLSelect\-Element::name () const}\label{classDOM_1_1HTMLSelectElement_a18}


Form control or object name when submitted with a form. 

See the {\tt name attribute definition } in HTML 4.0. 

Definition at line 824 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setName@{setName}}
\index{setName@{setName}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Name (const {\bf DOMString} \&)}\label{classDOM_1_1HTMLSelectElement_a19}


see name 



Definition at line 830 of file html\_\-form.cpp.

References value().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!size@{size}}
\index{size@{size}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}long HTMLSelect\-Element::size () const}\label{classDOM_1_1HTMLSelectElement_a20}


Number of visible rows. 

See the {\tt size attribute definition } in HTML 4.0. 

Definition at line 835 of file html\_\-form.cpp.

References DOM::DOMString::to\-Int().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setSize@{setSize}}
\index{setSize@{setSize}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Size (long)}\label{classDOM_1_1HTMLSelectElement_a21}


see size 



Definition at line 841 of file html\_\-form.cpp.

References value().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!tabIndex@{tabIndex}}
\index{tabIndex@{tabIndex}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}long HTMLSelect\-Element::tab\-Index () const}\label{classDOM_1_1HTMLSelectElement_a22}


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

See the {\tt tabindex attribute definition } in HTML 4.0. 

Definition at line 850 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!setTabIndex@{setTabIndex}}
\index{setTabIndex@{setTabIndex}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::set\-Tab\-Index (long)}\label{classDOM_1_1HTMLSelectElement_a23}


see tab\-Index 



Definition at line 856 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!add@{add}}
\index{add@{add}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::add (const {\bf HTMLElement} \& {\em element}, const {\bf HTMLElement} \& {\em before})}\label{classDOM_1_1HTMLSelectElement_a24}


Add a new element to the collection of {\tt OPTION} elements for this {\tt SELECT} . 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em element}]The element to add.\item[{\em before}]The element to insert before, or 0 for the tail of the list. \end{description}
\end{Desc}


Definition at line 862 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!remove@{remove}}
\index{remove@{remove}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::remove (long {\em index})}\label{classDOM_1_1HTMLSelectElement_a25}


Remove an element from the collection of {\tt OPTION} elements for this {\tt SELECT} . 

Does nothing if no element has the given index.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em index}]The index of the item to remove. \end{description}
\end{Desc}


Definition at line 873 of file html\_\-form.cpp.

References DOM::DOMString::remove().\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!blur@{blur}}
\index{blur@{blur}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::blur ()}\label{classDOM_1_1HTMLSelectElement_a26}


Removes keyboard focus from this element. 



Definition at line 878 of file html\_\-form.cpp.\index{DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}!focus@{focus}}
\index{focus@{focus}!DOM::HTMLSelectElement@{DOM::HTMLSelect\-Element}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void HTMLSelect\-Element::focus ()}\label{classDOM_1_1HTMLSelectElement_a27}


Gives keyboard focus to this element. 



Definition at line 884 of file html\_\-form.cpp.

The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
html\_\-form.h\item 
html\_\-form.cpp\end{CompactItemize}
