|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
javax.print.attribute.standard
类 PageRanges
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 是打印属性类,它是一个整数集,标识 Printer 对象为所要打印的每个文档的每份副本所使用的打印流页范围。对于那些标识为文档中不存在的页,将不会打印任何内容。该属性与打印流 页相关,而与应用程序编号的页无关(例如,某些字处理应用程序的标题或脚注中的页数)。
在大多数情况下,要打印的准确页数由设备驱动程序生成,因此不需要此属性。但是当打印已经格式化过的存档文档时,最终用户可以选择只打印该文档中所包含的页子集。在这种情况下,如果将页范围指定为 "n-m"
,则要打印的第一页将为页 n。将打印文档中后面所有的页,包括页 m。
如果没有为打印作业指定 PageRanges 属性,则将打印文档的中所有页。换句话说,PageRanges 属性的默认值始终是 {{1, Integer.MAX_VALUE}}
。
多文档打印作业(一个作业带有多个文档)的 PageRanges 属性的效果取决于是为所有的文档指定了相同的页范围,还是为不同的文档指定了不同的页范围,以及 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 "page-ranges" 属性。有关规范数组形式的解释,请参阅类 SetOfIntegerSyntax
。由 getName()
返回的类别名称提供了 IPP 属性名称。
- 另请参见:
- 序列化表格
构造方法摘要 | |
---|---|
PageRanges(int member) 构造一个包括单个整数的新 PageRanges 属性。 |
|
PageRanges(int[][] members) 构造具有给定成员的新 PageRanges 属性。 |
|
PageRanges(int lowerBound, int upperBound) 构造一个包括单一整数范围的新 PageRanges 属性。 |
|
PageRanges(String members) 构造具有给定成员(字符串形式)的新 PageRanges 属性。 |
方法摘要 | |
---|---|
boolean |
equals(Object object) 返回此 PageRanges 属性是否等效于传入的对象。 |
Class<? extends Attribute> |
getCategory() 获取将用作此打印属性值的“类别”的打印属性类。 |
String |
getName() 获取类别的名称,此属性值是该类别的一个实例。 |
从类 javax.print.attribute.SetOfIntegerSyntax 继承的方法 |
---|
contains, contains, getMembers, hashCode, next, toString |
从类 java.lang.Object 继承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
PageRanges
public PageRanges(int[][] members)
-
构造具有给定成员的新 PageRanges 属性。以“数组形式”指定这些成员,有关数组形式的解释,请参阅类
SetOfIntegerSyntax
。- 参数:
-
members
- 以数组形式设置的成员。 - 抛出:
-
NullPointerException
- (未经检查的异常)如果members
为 null,或者members
的任何元素为 null。 -
IllegalArgumentException
- (未经检查的异常)如果没有任何members
元素是长度为一或长度为二的数组。如果members
是长度为零的数组,或者集合中的任何成员都小于 1,则也会抛出此异常。
PageRanges
public PageRanges(String members)
-
构造具有给定成员(字符串形式)的新 PageRanges 属性。有关语法的解释,请参阅类
SetOfIntegerSyntax
。- 参数:
-
members
- 以字符串形式设置的成员。 - 抛出:
-
NullPointerException
- (未经检查的异常)如果members
为 null,或者members
的任何元素为 null。 -
IllegalArgumentException
- (未经检查的异常)如果members
没有遵守正确的语法。如果构造的整数集为零长度的数组,或者集合中的任何成员小于 1,则也会抛出此异常。
PageRanges
public PageRanges(int member)
-
构造一个包括单个整数的新 PageRanges 属性。也就是说只打印一页。
- 参数:
-
member
- 设置的成员。 - 抛出:
-
IllegalArgumentException
- (未经检查的异常)如果member
小于 1。
PageRanges
public PageRanges(int lowerBound, int upperBound)
-
构造一个包括单一整数范围的新 PageRanges 属性。也就是说只打印那些在一个范围中的页。
- 参数:
-
lowerBound
- 范围的下边界。 -
upperBound
- 范围的上边界。 - 抛出:
-
IllegalArgumentException
- (未经检查的异常)如果指定了 null 范围,或者指定了非 null 的范围,但lowerBound
小于 1。
方法详细信息 |
---|
equals
public boolean equals(Object object)
-
返回此 PageRanges 属性是否等效于传入的对象。若要等效,以下所有条件都必须为 true:
object
不为 null。object
是类 PageRanges 的一个实例。- 此 PageRanges 属性的成员和
object
的成员相同。
-
- 覆盖:
-
类
SetOfIntegerSyntax
中的equals
-
- 参数:
-
object
- 要比较的对象。 - 返回:
-
如果
object
等效于此 PageRanges 属性,则返回 True,否则返回 false。 - 另请参见:
-
Object.hashCode()
,Hashtable
getCategory
public final Class<? extends Attribute> getCategory()
-
获取将用作此打印属性值的“类别”的打印属性类。
对于类 PageRanges,该类别就是类 PageRanges 本身。
-
- 指定者:
-
接口
Attribute
中的getCategory
-
- 返回:
-
打印属性类(类别),这是类
java.lang.Class
的一个实例。
getName
public final String getName()
-
获取类别的名称,此属性值是该类别的一个实例。
对于类 PageRanges,该类别名称是
"page-ranges"
。 -
- 返回:
- 属性类别名称。
所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |