\section{DOM::Media\-List Class Reference}
\label{classDOM_1_1MediaList}\index{DOM::MediaList@{DOM::MediaList}}
The {\tt {\bf Media\-List}{\rm (p.\,\pageref{classDOM_1_1MediaList})}} interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented.  


{\tt \#include $<$css\_\-stylesheet.h$>$}

\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf Media\-List} (const {\bf Media\-List} \&other)\label{classDOM_1_1MediaList_a1}

\item 
{\bf Media\-List} (Media\-List\-Impl $\ast$impl)\label{classDOM_1_1MediaList_a2}

\item 
{\bf Media\-List} \& {\bf operator=} (const {\bf Media\-List} \&other)\label{classDOM_1_1MediaList_a3}

\item 
{\bf DOM::DOMString} {\bf media\-Text} () const 
\item 
void {\bf set\-Media\-Text} (const {\bf DOM::DOMString} \&value)
\item 
unsigned long {\bf length} () const 
\item 
{\bf DOM::DOMString} {\bf item} (unsigned long index) const 
\item 
void {\bf delete\-Medium} (const {\bf DOM::DOMString} \&old\-Medium)
\item 
void {\bf append\-Medium} (const {\bf DOM::DOMString} \&new\-Medium)
\item 
Media\-List\-Impl $\ast$ {\bf handle} () const \label{classDOM_1_1MediaList_a11}

\item 
bool {\bf is\-Null} () const \label{classDOM_1_1MediaList_a12}

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
Media\-List\-Impl $\ast$ {\bf impl}\label{classDOM_1_1MediaList_p0}

\end{CompactItemize}


\subsection{Detailed Description}
The {\tt {\bf Media\-List}{\rm (p.\,\pageref{classDOM_1_1MediaList})}} interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented. 

All media are lowercase strings. 



Definition at line 363 of file css\_\-stylesheet.h.

\subsection{Member Function Documentation}
\index{DOM::MediaList@{DOM::Media\-List}!mediaText@{mediaText}}
\index{mediaText@{mediaText}!DOM::MediaList@{DOM::Media\-List}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf DOM::DOMString} Media\-List::media\-Text () const}\label{classDOM_1_1MediaList_a5}


The parsable textual representation of the media list. 

This is a comma-separated list of media.

\begin{Desc}
\item[Exceptions:]
\begin{description}
\item[{\em DOMException}]SYNTAX\_\-ERR: Raised if the specified string value has a syntax error and is unparsable.\end{description}
\end{Desc}
NO\_\-MODIFICATION\_\-ALLOWED\_\-ERR: Raised if this media list is readonly. 

Definition at line 292 of file css\_\-stylesheet.cpp.\index{DOM::MediaList@{DOM::Media\-List}!setMediaText@{setMediaText}}
\index{setMediaText@{setMediaText}!DOM::MediaList@{DOM::Media\-List}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Media\-List::set\-Media\-Text (const {\bf DOM::DOMString} \& {\em value})}\label{classDOM_1_1MediaList_a6}


see media\-Text 



Definition at line 298 of file css\_\-stylesheet.cpp.\index{DOM::MediaList@{DOM::Media\-List}!length@{length}}
\index{length@{length}!DOM::MediaList@{DOM::Media\-List}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}unsigned long Media\-List::length () const}\label{classDOM_1_1MediaList_a7}


The number of media in the list. 

The range of valid media is 0 to length-1 inclusive. 

Definition at line 304 of file css\_\-stylesheet.cpp.

References DOM::DOMString::length().\index{DOM::MediaList@{DOM::Media\-List}!item@{item}}
\index{item@{item}!DOM::MediaList@{DOM::Media\-List}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf DOM::DOMString} Media\-List::item (unsigned long {\em index}) const}\label{classDOM_1_1MediaList_a8}


Returns the indexth in the list. 

If index is greater than or equal to the number of media in the list, this returns null.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em index}]Index into the collection.\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The medium at the indexth position in the {\bf Media\-List}{\rm (p.\,\pageref{classDOM_1_1MediaList})}, or null if that is not a valid index. \end{Desc}


Definition at line 310 of file css\_\-stylesheet.cpp.\index{DOM::MediaList@{DOM::Media\-List}!deleteMedium@{deleteMedium}}
\index{deleteMedium@{deleteMedium}!DOM::MediaList@{DOM::Media\-List}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Media\-List::delete\-Medium (const {\bf DOM::DOMString} \& {\em old\-Medium})}\label{classDOM_1_1MediaList_a9}


Deletes the medium indicated by old\-Medium from the list. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em old\-Medium}]The medium to delete in the media list.\end{description}
\end{Desc}
\begin{Desc}
\item[Exceptions:]
\begin{description}
\item[{\em DOMException}]NO\_\-MODIFICATION\_\-ALLOWED\_\-ERR: Raised if this list is readonly.\end{description}
\end{Desc}
NOT\_\-FOUND\_\-ERR: Raised if old\-Medium is not in the list. 

Definition at line 316 of file css\_\-stylesheet.cpp.\index{DOM::MediaList@{DOM::Media\-List}!appendMedium@{appendMedium}}
\index{appendMedium@{appendMedium}!DOM::MediaList@{DOM::Media\-List}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Media\-List::append\-Medium (const {\bf DOM::DOMString} \& {\em new\-Medium})}\label{classDOM_1_1MediaList_a10}


Adds the medium new\-Medium to the end of the list. 

If the new\-Medium is already used, it is first removed.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em new\-Medium}]The new medium to add.\end{description}
\end{Desc}
\begin{Desc}
\item[Exceptions:]
\begin{description}
\item[{\em DOMException}]INVALID\_\-CHARACTER\_\-ERR: If the medium contains characters that are invalid in the underlying style language.\end{description}
\end{Desc}
NO\_\-MODIFICATION\_\-ALLOWED\_\-ERR: Raised if this list is readonly. 

Definition at line 322 of file css\_\-stylesheet.cpp.

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