javax.print.attribute.standard

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 -- 所有输入文档将被合并为一个输出文档。每个介质纸张将由 ni 个取自输出文档的打印流页组成,其中 i 为对应于输出文档中该点的输入文档数。当下一个文档具有不同于前一个输入文档的计数值时,下一个输入文档的首个打印流页在下一个介质印张的开始处开始,可能保留少于前一个介质印张上的全部打印流页数。

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

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

    • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 输入文档将保持独立。对于输入文档 i, 每个介质印张将由 ni 个取自输入文档的打印流页组成。因为输入文档是独立的,所以每个输入文档的首个印张将总是在新介质纸张上开始;这意味着输入文档的最后一个印张上可能有少于 ni 个打印流页。
IPP Compatibility: 整数值给出了 IPP 整数值。 getName() 所返回的类别名称给出了 IPP 属性名称。

另请参见:
序列化表格

构造方法摘要
NumberUp(int value)
          构造具有给定整数值的新 NumberUp 属性。
 
方法摘要
 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)
构造具有给定整数值的新 NumberUp 属性。

参数:
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
返回:
属性类别名称。