FileDocCategorySizeDatePackage
MediaList.javaAPI DocJava SE 6 API3453Tue Jun 10 00:27:36 BST 2008org.w3c.dom.stylesheets

MediaList

public interface MediaList
The MediaList interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented. An empty list is the same as a list that contains the medium "all".

The items in the MediaList are accessible via an integral index, starting from 0.

See also the Document Object Model (DOM) Level 2 Style Specification.

since
DOM Level 2

Fields Summary
Constructors Summary
Methods Summary
public voidappendMedium(java.lang.String newMedium)
Adds the medium newMedium to the end of the list. If the newMedium is already used, it is first removed.

param
newMedium The new medium to add.
exception
DOMException INVALID_CHARACTER_ERR: If the medium contains characters that are invalid in the underlying style language.
NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.

public voiddeleteMedium(java.lang.String oldMedium)
Deletes the medium indicated by oldMedium from the list.

param
oldMedium The medium to delete in the media list.
exception
DOMException NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.
NOT_FOUND_ERR: Raised if oldMedium is not in the list.

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

public java.lang.StringgetMediaText()
The parsable textual representation of the media list. This is a comma-separated list of media.

public java.lang.Stringitem(int 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.

param
index Index into the collection.
return
The medium at the indexth position in the MediaList, or null if that is not a valid index.

public voidsetMediaText(java.lang.String mediaText)
The parsable textual representation of the media list. This is a comma-separated list of media.

exception
DOMException SYNTAX_ERR: Raised if the specified string value has a syntax error and is unparsable.
NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is readonly.