- java.lang.Object
-
- javax.print.attribute.SetOfIntegerSyntax
-
- javax.print.attribute.standard.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(int member)
构造包含单个整数的新页面范围属性。PageRanges(int[][] members)
使用给定成员构造新的页面范围属性。PageRanges(int lowerBound, int upperBound)
构造包含单个整数范围的新页面范围属性。PageRanges(String members)
使用字符串形式的给定成员构造新的页面范围属性。
-
-
-
构造方法详细信息
-
PageRanges
public PageRanges(int[][] members)
- 参数
-
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)
返回此页面范围属性是否等效于传入的对象。 为了等效,所有以下条件必须为真:-
object
不是null
。 -
object
是类PageRanges
的实例。 - 此页面范围属性的成员和
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
的实例
-
-