-
public interface MediaList
MediaList
接口提供有序的媒体集合的抽象,而不定义或约束此集合的实现方式。 空列表与包含介质"all"
的列表相同。MediaList
中的项目可通过整数索引访问,从0开始。- 从以下版本开始:
- 1.4,DOM Level 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:如果指定的字符串值具有语法错误且不可DOMException
此异常。
NO_MODIFICATION_ALLOWED_ERR:如果此媒体列表是只读的,则引发此异常。
-
getLength
int getLength()
列表中的媒体数量。 有效媒体的范围是0
到length-1
含)。
-
item
String item(int index)
返回列表中的index
。 如果index
大于或等于列表中的媒体数,则返回null
。- 参数
-
index
- 索引到集合中。 - 结果
-
在该介质
index
在个位置MediaList
,或null
如果不是有效的索引。
-
deleteMedium
void deleteMedium(String oldMedium) throws DOMException
从列表中删除oldMedium
指示的介质。- 参数
-
oldMedium
- 要在媒体列表中删除的媒体。 - 异常
-
DOMException
- NO_MODIFICATION_ALLOWED_ERR:如果此列表是只读的,则引发此异常。
NOT_FOUND_ERR:如果oldMedium
不在列表中,则oldMedium
。
-
appendMedium
void appendMedium(String newMedium) throws DOMException
将介质newMedium
添加到列表的末尾。 如果已使用newMedium
,则首先将其删除。- 参数
-
newMedium
- 要添加的新媒体。 - 异常
-
DOMException
- INVALID_CHARACTER_ERR:如果介质包含基础样式语言中无效的字符。
NO_MODIFICATION_ALLOWED_ERR:如果此列表是只读的,则引发。
-
-