## org.w3c.dom.stylesheets
Interface 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

Method Summary
`void` `appendMedium(java.lang.String newMedium)` Adds the medium `newMedium` to the end of the list.
`void` `deleteMedium(java.lang.String oldMedium)` Deletes the medium indicated by `oldMedium` from the list.
`int` `getLength()` The number of media in the list.
`java.lang.String` `getMediaText()` The parsable textual representation of the media list.
`java.lang.String` `item(int index)` Returns the `index`th in the list.
`void` `setMediaText(java.lang.String mediaText)` The parsable textual representation of the media list.

Method Detail

### getMediaText

    public java.lang.String getMediaText()

  The parsable textual representation of the media list. This is a comma-separated list of media.
  Throws:
    `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.

### setMediaText

    public void setMediaText(java.lang.String mediaText)
                      throws DOMException

  The parsable textual representation of the media list. This is a comma-separated list of media.
  Throws:
    `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.

### getLength

    public int getLength()

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

### item

    public java.lang.String item(int index)

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

### deleteMedium

    public void deleteMedium(java.lang.String oldMedium)
                      throws DOMException

  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.

### appendMedium

    public void appendMedium(java.lang.String newMedium)
                      throws DOMException

  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.

Copyright © 1999-2003 Apache XML Project. All Rights Reserved.