\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=91pt]{classDOM_1_1HTMLSelectElement__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for DOM::HTMLSelect\-Element:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=91pt]{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 
\begin{CompactList}\small\item\em The type of control created. \item\end{CompactList}\item 
long {\bf selected\-Index} () const 
\begin{CompactList}\small\item\em The ordinal index of the selected option. \item\end{CompactList}\item 
void {\bf set\-Selected\-Index} (long)
\begin{CompactList}\small\item\em see {\bf selected\-Index}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a7})} \item\end{CompactList}\item 
{\bf DOMString} {\bf value} () const 
\begin{CompactList}\small\item\em The current form control value. \item\end{CompactList}\item 
void {\bf set\-Value} (const  {\bf DOMString} \&)
\begin{CompactList}\small\item\em see {\bf value}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a9})} \item\end{CompactList}\item 
long {\bf length} () const 
\begin{CompactList}\small\item\em The number of options in this {\tt  SELECT } . \item\end{CompactList}\item 
{\bf HTMLForm\-Element} {\bf form} () const 
\begin{CompactList}\small\item\em {\bf This class or method is obsolete, it is provided for compatibility only.}. \item\end{CompactList}\item 
{\bf HTMLCollection} {\bf options} () const 
\begin{CompactList}\small\item\em The collection of {\tt  OPTION } elements contained by this element. \item\end{CompactList}\item 
bool {\bf disabled} () const 
\begin{CompactList}\small\item\em The control is unavailable in this context. \item\end{CompactList}\item 
void {\bf set\-Disabled} (bool)
\begin{CompactList}\small\item\em see {\bf disabled}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a14})} \item\end{CompactList}\item 
bool {\bf multiple} () const 
\begin{CompactList}\small\item\em If true, multiple {\tt  OPTION } elements may be selected in this {\tt  SELECT } . \item\end{CompactList}\item 
void {\bf set\-Multiple} (bool)
\begin{CompactList}\small\item\em see {\bf multiple}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a16})} \item\end{CompactList}\item 
{\bf DOMString} {\bf name} () const 
\begin{CompactList}\small\item\em Form control or object name when submitted with a form. \item\end{CompactList}\item 
void {\bf set\-Name} (const  {\bf DOMString} \&)
\begin{CompactList}\small\item\em see {\bf name}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a18})} \item\end{CompactList}\item 
long {\bf size} () const 
\begin{CompactList}\small\item\em Number of visible rows. \item\end{CompactList}\item 
void {\bf set\-Size} (long)
\begin{CompactList}\small\item\em see {\bf size}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a20})} \item\end{CompactList}\item 
long {\bf tab\-Index} () const 
\begin{CompactList}\small\item\em Index that represents the element's position in the tabbing order. \item\end{CompactList}\item 
void {\bf set\-Tab\-Index} (long)
\begin{CompactList}\small\item\em see {\bf tab\-Index}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a22})} \item\end{CompactList}\item 
void {\bf add} (const  {\bf HTMLElement} \&element, const  {\bf HTMLElement} \&before)
\begin{CompactList}\small\item\em Add a new element to the collection of {\tt  OPTION } elements for this {\tt  SELECT } . \item\end{CompactList}\item 
void {\bf remove} (long index)
\begin{CompactList}\small\item\em Remove an element from the collection of {\tt  OPTION } elements for this {\tt  SELECT } . \item\end{CompactList}\item 
void {\bf blur} ()
\begin{CompactList}\small\item\em Removes keyboard focus from this element. \item\end{CompactList}\item 
void {\bf focus} ()
\begin{CompactList}\small\item\em Gives keyboard focus to this element. \item\end{CompactList}\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 809 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 758 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 764 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 {\bf selected\-Index}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a7})} 



Definition at line 770 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 776 of file html\_\-form.cpp.

Referenced by set\-Size().\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 {\bf value}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a9})} 



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

References DOM::DOMString::implementation(), and DOM::DOMString::is\-Null().\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 788 of file html\_\-form.cpp.\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 This class or method is obsolete, it is provided for compatibility only.}. 

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

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

Definition at line 794 of file html\_\-form.cpp.\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 799 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 805 of file html\_\-form.cpp.\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 {\bf disabled}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a14})} 



Definition at line 811 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 817 of file html\_\-form.cpp.\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 {\bf multiple}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a16})} 



Definition at line 823 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 828 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 {\bf name}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a18})} 



Definition at line 834 of file html\_\-form.cpp.\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 839 of file html\_\-form.cpp.\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 {\bf size}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a20})} 



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

References QString::number(), and 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 854 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 {\bf tab\-Index}{\rm (p.\,\pageref{classDOM_1_1HTMLSelectElement_a22})} 



Definition at line 860 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 866 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 877 of file html\_\-form.cpp.\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 882 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 888 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}
