MediaList JDK 1.6)

Description

public interface MediaList

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

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:

Methods

Hide/Show inherited methods

public void appendMedium (String newMedium) throws DOMException

Adds the medium newMedium to the end of the list.

Adds the medium newMedium to the end of the list. If the
newMedium is already used, it is first removed.
Parameters:
- newMedium - The new medium to add.
Throws:
- 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 void deleteMedium (String oldMedium) throws DOMException

Deletes the medium indicated by oldMedium from the list.

Deletes the medium indicated by oldMedium from the list.
Parameters:
- oldMedium - The medium to delete in the media list.
Throws:
- DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.
NOT_FOUND_ERR: Raised if oldMedium is not in the list.

public int getLength ()

The number of media in the list.

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

public String getMediaText ()

The parsable textual representation of the media list.

public String item (int index)

Returns the indexth in the list.

Returns the indexth in the list. If index is
greater than or equal to the number of media in the list, this
returns null.
Returns: The medium at the indexth position in the MediaList, or null if that is not a valid index.
Parameters:
- index - Index into the collection.

public void setMediaText (String mediaText) throws DOMException

The parsable textual representation of the media list.