Module  jdk.xml.dom
软件包  org.w3c.dom.stylesheets

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​()
        列表中的媒体数量。 有效媒体的范围为0至length-1含）。

      • item

        String item​(int index)
        返回列表中的index th。 如果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：如果此列表是只读的，则引发。