模块  java.desktop
软件包  javax.print.attribute.standard

Class PageRanges

  • 实现的所有接口
    Serializable ， Cloneable ， Attribute ， DocAttribute ， PrintJobAttribute ， PrintRequestAttribute 
    public final class PageRanges
extends SetOfIntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
    类PageRanges是打印属性类，一组整数，用于标识打印机对象用于每个要打印的文档的每个副本的打印流页面的范围。 对于文档中不存在的任何已识别页面，不会打印任何内容。 该属性与打印流页面相关联，而不是应用程序编号的页面（例如，在某些文字处理应用程序的页眉和/或页脚中找到的页码）。

    在大多数情况下，要打印的确切页面将由设备驱动程序生成，并且不需要此属性。 但是，当打印已经格式化的存档文档时，最终用户可以选择仅打印文档中包含的页面的子集。 在这种情况下，如果指定了页面范围"n-m" ， "n-m"打印的第一页将是第n页。 该文档的所有后续页面将通过页面m打印并包括页面m。

    如果未为打印作业指定PageRanges属性，则将打印文档的所有页面。 换句话说， PageRanges属性的默认值始终为{{1, Integer.MAX_VALUE}} 。

    PageRanges属性对multidoc打印作业（具有多个文档的作业）的影响取决于是否所有文档都指定了相同的页面范围，或者是否指定了不同的文档具有不同的页面范围，以及是否（可能是默认的）值MultipleDocumentHandling属性。

    • 如果所有文档都指定了相同的页面范围，则任何值MultipleDocumentHandling都有意义，并且打印机的处理取决于MultipleDocumentHandling值：
      • SINGLE_DOCUMENT - 所有输入文档将合并为一个输出文档。 将打印该输出文档的指定页面范围。
      • SINGLE_DOCUMENT_NEW_SHEET - 所有输入文档将合并为一个输出文档，每个输入文档的第一印象将始终在新的媒体工作表上开始。 将打印该输出文档的指定页面范围。
      • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - 对于每个单独的输入文档，将打印指定的页面范围。
      • SEPARATE_DOCUMENTS_COLLATED_COPIES - 对于每个单独的输入文档，将打印指定的页面范围。
      • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - 对于每个单独的输入文档，将打印其自己的指定页面范围。
      • SEPARATE_DOCUMENTS_COLLATED_COPIES - 对于每个单独的输入文档，将打印其自己的指定页面范围。

    IPP兼容性： PageRanges属性的规范数组形式给出了要包含在的每个页面范围和IPP“页面范围”属性的下限和上限。 有关规范数组形式的说明，请参见类SetOfIntegerSyntax 。 getName()返回的类别名称给出了IPP属性名称。

    另请参见：
    Serialized Form

    • 构造方法详细信息

      • PageRanges

        public PageRanges​(int[][] members)
        使用给定成员构造新的页面范围属性。 成员以“数组形式”指定; 有关数组形式的说明，请参阅类SetOfIntegerSyntax 。
        参数
        members - 以数组形式设置成员
        异常
        NullPointerException -如果 members是 null或任何元件 members是 null
        IllegalArgumentException -如果任何元件members不是长度为一个或长度×2阵列。 此外，如果members是零长度数组或该集合的任何成员小于1。

      • PageRanges

        public PageRanges​(String members)
        使用字符串形式的给定成员构造新的页面范围属性。 有关语法的说明，请参阅类SetOfIntegerSyntax 。
        参数
        members - 以字符串形式设置成员
        异常
        NullPointerException -如果 members是 null或任何元件 members是 null
        IllegalArgumentException - 如果members不遵守正确的语法。 此外，如果构造的整数组是零长度数组或者该组的任何成员小于1。

      • PageRanges

        public PageRanges​(int member)
        构造包含单个整数的新页面范围属性。 也就是说，只打印一页。
        参数
        member - 设置成员
        异常
        IllegalArgumentException - 如果 member < 1

      • PageRanges

        public PageRanges​(int lowerBound,
                  int upperBound)
        构造包含单个整数范围的新页面范围属性。 也就是说，只打印一个范围内的那些页面。
        参数
        lowerBound - 范围的下限
        upperBound - 范围的上限
        异常
        IllegalArgumentException - 如果指定了 null范围或指定了 non-null范围且 lowerBound小于1

    • 方法详细信息

      • equals

        public boolean equals​(Object object)
        返回此页面范围属性是否等效于传入的对象。 为了等效，所有以下条件必须为真：
        1. object不是null 。
        2. object是类PageRanges的实例。
        3. 此页面范围属性的成员和object的成员是相同的。
        重写：
        equals类 SetOfIntegerSyntax
        参数
        object - Object来比较
        结果
        true如果 object等效于此页面范围属性， false
        另请参见：
        Object.hashCode() ， HashMap

      • getCategory

        public final 类<? extends Attribute> getCategory()
        获取将用作此打印属性值的“类别”的打印属性类。

        对于类PageRanges ，该类别本身是PageRanges类。

        Specified by:
        getCategory ，界面 Attribute
        结果
        打印属性类（类别），类java.lang.Class的实例

      • getName

        public final String getName()
        获取此属性值为实例的类别的名称。

        对于类PageRanges ，类别名称为"page-ranges" 。

        Specified by:
        getName接口 Attribute
        结果
        属性类别名称