class MediaList

The <code> MediaList </code> interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented. More...

Full nameDOM::MediaList
Definition#include <css_stylesheet.h>
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Protected Members


Detailed Description

The <code> MediaList </code> interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented. All media are lowercase strings.

DOM::DOMString  mediaText ()

The parsable textual representation of the media list. This is a comma-separated list of media.

NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is readonly.

Throws: DOMException, SYNTAX_ERR:, Raised, if, the, specified, string, value, has, a, syntax, error, and, is, unparsable.

void  setMediaText (const DOM::DOMString &value)

see mediaText

unsigned long  length ()

The number of media in the list. The range of valid media is 0 to length-1 inclusive.

DOM::DOMString  item (unsigned long index)

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

Parameters:
indexIndex into the collection.

Returns: The medium at the indexth position in the MediaList, or null if that is not a valid index.

void  deleteMedium (const DOM::DOMString &oldMedium)

Deletes the medium indicated by oldMedium from the list.

NOT_FOUND_ERR: Raised if oldMedium is not in the list.

Parameters:
oldMediumThe medium to delete in the media list.

Throws: DOMException, NO_MODIFICATION_ALLOWED_ERR:, Raised, if, this, list, is, readonly.

void  appendMedium (const DOM::DOMString &newMedium)

Adds the medium newMedium to the end of the list. If the newMedium is already used, it is first removed.

NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.

Parameters:
newMediumThe new medium to add.

Throws: DOMException, INVALID_CHARACTER_ERR:, If, the, medium, contains, characters, that, are, invalid, in, the, underlying, style, language.


Generated by: ssk@tauon.ph.unimelb.EDU.AU on Wed May 23 05:55:52 2001, using kdoc 2.0a35.