public interface MediaList

MediaListインタフェースでは、このコレクションの実装方法を定義したり制約したりすることなく、メディアの順序付けされたコレクションの抽象化を提供します。空のリストは、メディア"all"が含まれるリストと同じです。

MediaList内の項目には、ゼロから始まる整数のインデックスを使用してアクセスできます。

「Document Object Model (DOM) Level 2 Style Specification」も参照してください。

導入されたバージョン:: 1.4、DOMレベル2

メソッドのサマリー

修飾子と型

メソッド

説明

void

appendMedium(String newMedium)

メディアnewMediumをリストの末尾に追加します。

void

deleteMedium(String oldMedium)

oldMediumで示されるメディアをリストから削除します。

int

getLength()

リスト内のメディア数。

String

getMediaText()

メディア・リストの、構文解析できるテキスト表現。

String

item(int index)

リストのindex番目を返します。

void

setMediaText(String mediaText)

メディア・リストの、構文解析できるテキスト表現。

メソッドの詳細
- getMediaText
  
  String getMediaText()
  
  メディア・リストの、構文解析できるテキスト表現。カンマで区切ったメディアのリストです。
- setMediaText
  
  void setMediaText(String mediaText) throws DOMException
  
  メディア・リストの、構文解析できるテキスト表現。カンマで区切ったメディアのリストです。
  
  例外:
  
  DOMException - SYNTAX_ERR: 指定した文字列値に構文エラーがあり、解析できない場合に発生する。
  NO_MODIFICATION_ALLOWED_ERR: このメディア・リストが読取り専用の場合に発生する。
- getLength
  
  int getLength()
  
  リスト内のメディア数。有効なメディアの範囲は、0からlength-1まで(両端を含む)です。
- item
  
  String item(int index)
  
  リストのindex番目を返します。 indexがリスト内のメディアの数以上である場合はnullを返します。
  
  パラメータ:
  
  index - コレクション内のインデックス。
  
  戻り値:
  
  MediaListのindex番目の位置にあるメディア。インデックスが有効でない場合はnull。
- deleteMedium
  
  void deleteMedium(String oldMedium) throws DOMException
  
  oldMediumで示されるメディアをリストから削除します。
  
  パラメータ:
  
  oldMedium - メディア・リストから削除するメディア。
  
  例外:
  
  DOMException - NO_MODIFICATION_ALLOWED_ERR: このリストが読取り専用の場合に発生する。
  NOT_FOUND_ERR: oldMediumがリストにない場合に発生する。
- appendMedium
  
  void appendMedium(String newMedium) throws DOMException
  
  メディアnewMediumをリストの末尾に追加します。 newMediumがすでに使用されている場合は、先に削除されます。
  
  パラメータ:
  
  newMedium - 追加する新しいメディア。
  
  例外:
  
  DOMException - INVALID_CHARACTER_ERR: 基盤となるスタイル言語で無効な文字がメディアに含まれる場合。
  NO_MODIFICATION_ALLOWED_ERR: このリストが読取り専用の場合に発生する。

インタフェースMediaList

メソッドのサマリー

メソッドの詳細

getMediaText

setMediaText

getLength

item

deleteMedium

appendMedium