javax.print.attribute.standard
类 NumberUp

java.lang.Object
  javax.print.attribute.IntegerSyntax
      javax.print.attribute.standard.NumberUp

所有已实现的接口：

Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute

public final class NumberUp
extends IntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

NumberUp 类是整数值形式的打印属性类，它指定了要放置于选中介质的实例一端上的打印流页数。也就是说，如果 NumberUp 值为 n，则打印机必须将 n 个打印流页放置于选中介质的实例一端上。要完成此功能，打印机可以添加某种转换、缩放或旋转。此属性主要控制打印流页的转换、缩放和旋转。

多文档打印作业（具有多个文档的作业）上的 NumberUp 属性的效果取决于是否所有文档均已指定相同的计数值，或者是否不同文档已指定不同计数值，并取决于（可能是默认的）MultipleDocumentHandling 属性的值。

• 如果所有文档均已指定了相同计数值 n，则 MultipleDocumentHandling 的任何值均有意义，且打印机的处理取决于 MultipleDocumentHandling 值：
  • SINGLE_DOCUMENT －－ 所有输入文档将被合并为一个输出文档。每个介质印张将由 nm 个取自输出文档的打印流页组成。

  • SINGLE_DOCUMENT_NEW_SHEET －－ 所有输入文档将被合并为一个输出文档。每个介质印张将由 n 个取自输出文档的打印流页组成。但是，每个输入文档的首个印张将总是在新介质纸张上开始；这意味着输入文档的最后一个印张上可能有少于 n 个打印流页。

  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES －－ 输入文档将保持独立。每个介质印张将由 n 个取自输入文档的打印流页组成。因为输入文档是独立的，所以每个输入文档的首个印张将总是在新介质纸张上开始；这意味着输入文档的最后一个印张上可能有少于 n 个打印流页。

  • SEPARATE_DOCUMENTS_COLLATED_COPIES －－ 输入文档将保持独立。每个介质印张将由 n 个取自输入文档的打印流页组成。因为输入文档是独立的，所以每个输入文档的首个印张将总是在新介质纸张上开始；这意味着输入文档的最后一个印张上可能有少于 n 个打印流页。
  • SINGLE_DOCUMENT －－ 所有输入文档将被合并为一个输出文档。每个介质纸张将由 n_i 个取自输出文档的打印流页组成，其中 i 为对应于输出文档中该点的输入文档数。当下一个文档具有不同于前一个输入文档的计数值时，下一个输入文档的首个打印流页在下一个介质印张的开始处开始，可能保留少于前一个介质印张上的全部打印流页数。

  • SINGLE_DOCUMENT_NEW_SHEET －－ 所有输入文档将被合并为一个输出文档。每个介质印张将由 n 个取自输出文档的打印流页组成。但是，每个输入文档的首个印张将总是在新介质纸张上开始；这意味着输入文档的最后一个印张上可能有少于 n 个打印流页。

  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES －－ 输入文档将保持独立。对于输入文档 i， 每个介质印张将由 n_i 个取自输入文档的打印流页组成。因为输入文档是独立的，所以每个输入文档的首个印张将总是在新介质纸张上开始；这意味着输入文档的最后一个印张上可能有少于 n_i 个打印流页。

  • SEPARATE_DOCUMENTS_COLLATED_COPIES －－ 输入文档将保持独立。对于输入文档 i， 每个介质印张将由 n_i 个取自输入文档的打印流页组成。因为输入文档是独立的，所以每个输入文档的首个印张将总是在新介质纸张上开始；这意味着输入文档的最后一个印张上可能有少于 n_i 个打印流页。

IPP Compatibility: 整数值给出了 IPP 整数值。getName() 所返回的类别名称给出了 IPP 属性名称。

另请参见：

序列化表格

构造方法摘要

NumberUp(int value)
构造具有给定整数值的新计数属性。

方法摘要

boolean	equals(Object object) 返回此计数属性是否等效于传入的对象。
Class<? extends Attribute>	getCategory() 获取将被用作此打印属性值的“类别”的打印属性类。
String	getName() 获取类别名称，此属性值为该类别的实例。

从类 javax.print.attribute.IntegerSyntax 继承的方法

getValue, hashCode, toString

从类 java.lang.Object 继承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

NumberUp

public NumberUp(int value)

构造具有给定整数值的新计数属性。

参数：

value - 整数值。

抛出：

IllegalArgumentException（未检查的异常）如果 - value 小于 1，则抛出该异常。

方法详细信息

equals

public boolean equals(Object object)

返回此计数属性是否等效于传入的对象。若要等效，以下所有条件都必须为 true：

1. object 不为 null。
2. object 为 NumberUp 类的实例。
3. 此计数属性的值与 object 的值相等。

覆盖：

类 IntegerSyntax 中的 equals

参数：

object - 要比较的 Object。

返回：

如果 object 等效于此计数属性，则返回 true，否则返回 false。

另请参见：

Object.hashCode(), Hashtable

getCategory

public final Class<? extends Attribute> getCategory()

获取将被用作此打印属性值的“类别”的打印属性类。

对于 NumberUp 类，类别为 NumberUp 类本身。

指定者：

接口 Attribute 中的 getCategory

返回：

打印属性类（类别），它是 java.lang.Class 类的实例。

getName

public final String getName()

获取类别名称，此属性值为该类别的实例。

对于 NumberUp 类，类别名称为 "number-up"。

指定者：

接口 Attribute 中的 getName

返回：

属性类别名称。