模块  jdk.xml.dom

Interface MediaList


  • public interface MediaList
    MediaList接口提供有序的媒体集合的抽象,而不定义或约束此集合的实现方式。 空列表与包含介质"all"的列表相同。

    MediaList中的项目可通过整数索引访问,从0开始。

    另见Document Object Model (DOM) Level 2 Style Specification

    从以下版本开始:
    1.4,DOM Level 2
    • 方法详细信息

      • getMediaText

        String getMediaText()
        媒体列表的可解析文本表示。 这是一个以逗号分隔的媒体列表。
      • setMediaText

        void setMediaText​(String mediaText)
                   throws DOMException
        媒体列表的可解析文本表示。 这是一个以逗号分隔的媒体列表。
        异常
        DOMException - SYNTAX_ERR:如果指定的字符串值具有语法错误且不可DOMException此异常。
        NO_MODIFICATION_ALLOWED_ERR:如果此媒体列表是只读的,则引发此异常。
      • getLength

        int getLength()
        列表中的媒体数量。 有效媒体的范围是0length-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:如果此列表是只读的,则引发。