JavaTM Platform
Standard Ed. 6

软件包 javax.print.attribute.standard

包 javax.print.attribute.standard 包括特定打印属性的类。

请参见:
          描述

类摘要
Chromaticity Chromaticity 类是打印属性类,它是一个枚举值,指定单色打印或彩色打印。
ColorSupported ColorSupported 类是打印属性类,它是一个枚举值,标识了设备是否能够支持任何类型的彩色打印,包括高亮颜色和全处理颜色 (full process color)。
Compression Compression 类是打印属性类,它是一个枚举值,指定如何压缩打印数据。
Copies Copies 类是整数值形式的打印属性类,它指定了要打印的份数。
CopiesSupported CopiesSupported 类是打印属性类,它是一个整数集,给出了支持的 Copies 属性的值。
DateTimeAtCompleted DateTimeAtCompleted 类是打印属性类,它是一个日期-时间属性,指示 Print Job 完成(或取消或中止)的日期和时间。
DateTimeAtCreation DateTimeAtCreation 类是打印属性类,它是一个日期-时间属性,指示创建 Print Job 时的日期和时间。
DateTimeAtProcessing DateTimeAtProcessing 类是打印属性类,它是一个日期-时间属性,指示首次开始处理 Print Job 的日期和时间。
Destination Destination 类是打印属性类,它是一个 URI,用于指示进入缓冲池的打印机格式的数据的可选目标。
DocumentName DocumentName 类是打印属性类,它是一个文本属性,指定了文档名称。
Fidelity Fidelity 类是打印属性类,它是一个枚举值,指示客户机提供的请求属性是否要求具有总体保真度。
Finishings Finishings 类是打印属性类,它是一个枚举值,标识了打印机是否将某个正在完成的某类绑定操作应用到作业中每个打印文档的每个副本中。
JobHoldUntil JobHoldUntil 类是打印属性类,它是一个日期-时间属性,指定了作业必须成为候选打印作业的准确日期和时间。
JobImpressions JobImpressions 类是整数值形式的打印属性类,它指定了正提交的文档(或多个文档)的印张的总大小。
JobImpressionsCompleted JobImpressionsCompleted 类是整数值形式的打印属性类,它指定了到目前为止已完成作业的印数。
JobImpressionsSupported JobImpressionsSupported 类是打印属性类,它是一个整数集,给出了支持的 JobImpressions 属性值。
JobKOctets JobKOctets 类是整数值形式的打印属性类,它指定了以 K 字节为单位的文档总大小,即以要在作业中处理的所请求的 1024 字节为单位。
JobKOctetsProcessed JobKOctetsProcessed 类是整数值形式的打印属性类,它指定了到目前为止已处理的打印数据字节总数,以 K 字节为单位,即以 1024 字节为单位。
JobKOctetsSupported JobKOctetsSupported 类是打印属性类,它是一个整数集,给出了支持的 JobKOctets 属性的值。
JobMediaSheets JobMediaSheets 类是整数值形式的打印属性类,它指定了要为此作业生成的介质纸张总数。
JobMediaSheetsCompleted JobMediaSheetsCompleted 类是整数值形式的打印属性类,它指定了到目前为止全部作业的已完成标记和堆栈的介质纸张数,不管这些纸张完成的是单面处理还是双面处理。
JobMediaSheetsSupported Class JobMediaSheetsSupported 类是打印属性类,它是一个整数集,给出了支持的 JobMediaSheets 属性。
JobMessageFromOperator JobMessageFromOperator 类是打印属性类,它是一个文本属性,提供操作员、系统管理员或“智能”进程传来的消息,向终端用户指示某个作业上的修改或其他管理操作的原因。
JobName JobName 类是打印属性类,它是一个文本属性,指定了打印作业的名称。
JobOriginatingUserName JobOriginatingUserName 类是打印属性类,它是一个文本属性,包含提交打印作业的终端用户的名称。
JobPriority JobPriority 类是整数值形式的打印属性类,它指定了打印作业的优先级。
JobPrioritySupported JobPrioritySupported 类是整数值形式的打印属性类,它指定了 Print Service 实例是否支持 JobPriority 属性,以及支持的不同作业优先级数目。
JobSheets JobSheets 类是打印属性类,它是一个枚举值,确定必须打印作业的开始页和结束页(如果有)。
JobState JobState 是打印属性类,它是一个枚举值,标识了打印作业的当前状态。
JobStateReason JobStateReason 类是打印属性类,它是一个枚举值,提供了有关作业当前状态的额外信息,例如,扩充作业的 JobState 属性值的信息。
JobStateReasons JobStateReasons 类是打印属性类,它是一个枚举值集合,提供了有关作业当前状态的额外信息,即扩充作业的 JobState 属性值的信息。
Media Media 类是打印属性类,它指定了要在其上打印的介质。
MediaName MediaName 类是 Media 的子类,它是打印属性类(一个枚举),以名称形式指定了打印作业的介质。
MediaPrintableArea MediaPrintableArea 类是打印属性类,用于区分介质的可打印区域和不可打印区域。
MediaSize MediaSize 是二维大小值形式的打印属性类,它指示纵向方向中的介质维度,其中 X 维度沿底边计算,Y 维度沿左边计算。
MediaSize.Engineering MediaSize.Engineering 类包括 engineering 介质的 MediaSize 值。
MediaSize.ISO MediaSize.ISO 类包括 ISO 介质的 MediaSize 值。
MediaSize.JIS MediaSize.JIS 类包括 JIS (Japanese) 介质的 MediaSize 值。
MediaSize.NA MediaSize.NA 类包括 North American 介质的 MediaSize 值。
MediaSize.Other MediaSize.Other 类包括其他介质的 MediaSize 值。
MediaSizeName MediaSizeName 类是 Media 的子类。
MediaTray MediaTray 类是 Media 的子类。
MultipleDocumentHandling MultipleDocumentHandling 类是打印属性类,它是一个枚举值,控制结束操作和一个或多个打印流在印张中和在介质纸张上的布局。
NumberOfDocuments NumberOfDocuments 类是整数值形式的打印属性类,它指示打印机已接受此作业的单份文档数,而不管文档的打印数据是否已到达打印机。
NumberOfInterveningJobs NumberOfInterveningJobs 类是整数值形式的打印属性类,它指示在此作业之前的作业数,这些作业按期望完成的相对时间顺序排序(即当前安排的顺序)。
NumberUp NumberUp 类是整数值形式的打印属性类,它指定了要放置于选中介质的实例单面上的打印流页数。
NumberUpSupported NumberUpSupported 类是打印属性类,它是一个整数集,给出了支持的 NumberUp 属性值。
OrientationRequested OrientationRequested 类是打印属性类,它是一种枚举,指示所打印的打印流页的所需方向;但它不描述客户端提供的打印流页的方向。
OutputDeviceAssigned OutputDeviceAssigned 类是打印属性类,它是一种文本属性,标识了服务将此作业所分配到的输出设备。
PageRanges PageRanges 类是打印属性类,它是一个整数集,标识 Printer 对象为所要打印的每个文档的每份副本所使用的打印流页范围。
PagesPerMinute PagesPerMinute 类是一个整数值的打印属性,它指示与此打印机可生成(例如在单工、黑白设置下)的总页数最接近的每分钟可以生成的额定页数。
PagesPerMinuteColor PagesPerMinuteColor 类是一个整数值的打印属性,它指示与此打印机可生成(例如在单工、彩色设置下)的总页数最接近的每分钟可以生成的额定页数。
PDLOverrideSupported PDLOverrideSupported 类是打印属性类,它是一种枚举,表示可使用以打印数据外部的属性方式所指定的处理指令,来重写嵌入到文档打印数据中的处理指令。
PresentationDirection PresentationDirection 类是打印属性类,它是一种枚举,它与 NumberUp 属性结合使用,以指示应用于所选单面介质实例上多个打印流页的布局。
PrinterInfo PrinterInfo 类是打印属性类,它是一种文本属性,提供了有关打印机的描述性信息。
PrinterIsAcceptingJobs PrinterIsAcceptingJobs 类是打印属性类,它是一种枚举,指示打印机当前是否能够接受作业。
PrinterLocation PrinterLocation 类是打印属性类,它是一种文本属性,标识了设备的位置。
PrinterMakeAndModel PrinterMakeAndModel 类是打印属性类,它是一种文本属性,说明打印机的制造和型号。
PrinterMessageFromOperator PrinterMessageFromOperator 类是打印属性类,它是一种文本属性,提供操作员、系统管理员或“智能”进程传来的处理中的消息,可向最终用户指示有关打印机状态(如为什么不可用或者希望何时可用)的信息。
PrinterMoreInfo PrinterMoreInfo 类是打印属性类,它是一种 URI,用来获取有关此特定打印机的更多信息。
PrinterMoreInfoManufacturer PrinterMoreInfoManufacturer 类是打印属性类,它是一种 URI,用于获取有关此类型设备的更多信息。
PrinterName PrinterName 类是打印属性类,它是一种文本属性,指定了打印机的名称。
PrinterResolution PrinterResolution 类是打印属性类,指定了打印机支持的或将用于打印作业的精确分辨率。
PrinterState PrinterState 类是打印机属性类,它是一种枚举,标识了打印机的当前状态。
PrinterStateReason PrinterStateReason 类是打印属性类,它是一个枚举值,提供了有关打印机当前状态的附加信息,即扩充了打印机 PrinterState 属性值的信息。
PrinterStateReasons PrinterStateReasons 类是打印属性类,它是一组枚举值集合,提供了有关打印机当前状态的附加信息,即扩充了打印机 PrinterState 属性值的信息。
PrinterURI PrinterURI 类是打印属性类,它是一个 URI,指定了全局唯一的打印机名称。
PrintQuality PrintQuality 类是打印属性类,它是一种枚举,指定了打印机为该作业使用的打印质量。
QueuedJobCount QueuedJobCount 类是整数值打印属性,它指示了其 JobState 是 PENDING、PENDING_HELD、PROCESSING 或 PROCESSING_STOPPED 的打印机中的作业数。
ReferenceUriSchemesSupported ReferenceUriSchemesSupported 类是打印属性类,它是一种枚举,指示了“URI 方案”(如 "http:"或 "ftp:"),打印机可使用它来获取存储在 URI 位置的打印数据。
RequestingUserName RequestingUserName 类是打印属性类,它是一种文本属性,指定了提交打印作业的最终用户的名称。
Severity Severity 类是打印属性类,它是一种枚举,表示 PrinterStateReason 属性的严重性。
SheetCollate SheetCollate 类是打印属性类,它是一种枚举,当由 Copies 属性指定了文档的多个副本时,它可以指定作业中每个打印文档的每个副本的介质纸张是否排列有序。
Sides Sides 类是打印属性类,它是一种枚举,指定了如何将打印流页应用于选定介质实例的各面(即一个印张)。
 

软件包 javax.print.attribute.standard 的描述

包 javax.print.attribute.standard 包括特定打印属性的类。父包 javax.print.attribute 提供了描述 Java Print Service 属性的类型以及如何分类这些属性的类和接口。

属性表示打印服务可以提供的打印功能。对于每种属性,打印服务要么支持该属性,要么不支持该属性。对于受支持属性的每个可能值,打印服务要么支持该值,要么不支持该值。

API 需要每种打印服务都支持某些属性;其他属性是可选的,并且服务可以选择是否支持它们。每种属性都有一组它可接受的值。API 需要每种打印服务都支持某些属性的某些值;其他属性值是可选的,并且服务可以选择是否支持它们。这些支持要求记录在每个属性类的文档中。

包 javax.print.attribute.standard 包含广泛应用于打印域的标准打印属性和标准打印属性值。除了标准打印属性,打印服务供应商还可以提供特定于供应商的新打印属性。供应商还可以提供标准打印属性的特定于供应商的扩展(子类) -- 例如,为现有的标准属性提供其他特定于供应商的值。当然,如果某个供应商希望客户端能够使用任何添加或扩展的属性,则该供应商必须公布新的属性类。

许多标准属性类都扩展了 javax.print.attribute 包的某个抽象语法类。这些抽象语法类分别表示不同的类型。例如,EnumSyntax 类表示类型安全的枚举。抽象语法类为属性值提供了包装器。

如果某个属性类扩展 EnumSyntax,并且该属性的值是 IPP 可兼容的值,则该属性的 toString 方法将返回属性值的 IPP 字符串表示形式,例如,JobState 属性的字符串表示形式 "processing-stopped"。不过,由于 EnumSyntax 类是可扩展的,所以供应商可以定义其自己的属性值。如果属性使用 EnumSyntax 类并且被设置为某个供应商定义的值,则 toString 方法将不会返回该值的 IPP 字符串表示形式。

打印客户端应用程序一般不需要使用包 javax.print.attribute.standard 中的全部打印属性类,只需要与该应用程序相关的那些打印属性类。

包 javax.print.attribute.standard 中的属性类基于发表于 2000 年 9 月的 RFC 文档 RFC 2911 Internet Printing Protocol/1.1:Model and Semantics 中定义的 Internet Printing Protocol (IPP) 属性。有关更多信息,请参阅 RFC 2911。各种属性类的描述性文本大部分摘自于上述文档。感谢上述作者对 API 所做的贡献。

属性组织

有以下五种打印属性:doc 属性、print request 属性、print job 属性、print service 属性和 supported-values 属性。

Doc 属性

Doc 属性指定了每个 doc 的特征和应用于每个 doc 的打印作业设置。doc 属性类实现了接口 DocAttribute。doc 属性可以出现在 DocAttributeSet 中。

Print Request 属性

Print request 属性指定了将应用于整个打印作业和打印作业中所有 doc 的设置。print request 属性类实现了接口 PrintRequestAttribute。print request 属性可以出现在 PrintRequestAttributeSet 中。

有些属性是 doc 属性,但却不是 print request 属性,并且只能在 doc 级指定。有些属性是 print request 属性,但却不是 doc 属性,并且只能在 Print Request 级指定。有些属性既是 doc 属性又是 print request 属性,并且可以在 doc 级或 Print Request 级指定。

当在 doc 级指定时,属性仅应用于该级中的一个 doc。当在 Print Request 级指定时,属性则应用于整个作业,其中包括该作业中的所有 doc。但是,在 doc 级指定的属性会覆盖在 Print Request 级指定的同一类别中的属性。

Print Job 属性

Print job 属性报告“打印作业”的状态。print job 属性类实现了接口 PrintJobAttribute。print job 属性可以出现在 PrintJobAttributeSet 中。

有些属性既是 print request 属性又是 print job 属性;客户端可以将这些属性包括在 Print Request 中以指定确定出现的 PrintJob 的特征,并且这些属性还可以出现在该 PrintJob 的属性集中。有些属性是 print job 属性,但却不是 print request 属性;打印服务本身可以将这些属性添加到 PrintJob 的属性集中。

Print Service 属性

Print service 属性报告打印服务的状态。print service 属性类实现了接口 PrintServiceAttribute。print service 属性可以出现在 PrintServiceAttributeSet 中。

Supported-Values 属性

supported-value 属性指示打印服务支持的另一个属性的合法值。supported-values 属性类实现了接口 SupportedValuesAttribute。但是 supported-values 属性从不会出现在属性集中,所以它们没有受限制的 AttributeSet 子接口。

属性表

下表列出了所有打印属性。该表显示了除接口 Attribute 之外每个属性类实现的标记接口,因此指示每种属性在 API 中的使用方式。对于每个 doc 属性和 print request 属性,标记为 "SupportedValuesAttribute" 的这一列列出了 supported-values 属性类(如果有),使用它打印服务可以指示该属性类别所支持的值。

属性类 Doc
属性
Print
Request
属性
Print
Job
属性
Print
Service
属性
SupportedValuesAttribute
Compression X        
DocumentName X        
Chromaticity X X X    
Copies   X X   CopiesSupported
Finishings X X X    
JobHoldUntil   X X    
JobImpressions   X X   JobImpressionsSupported
JobKOctets   X X   JobKOctetsSupported
JobMediaSheets   X X   JobMediaSheetsSupported
JobName   X X    
JobPriority   X X   JobPrioritySupported
JobSheets   X X    
Media X X X    
MediaSize          
MultipleDocumentHandling   X X    
NumberUp X X X   NumberUpSupported
OrientationRequested X X X    
PageRanges X X X    
PresentationDirection X X X    
PrinterResolution X X X    
PrintQuality X X X    
RequestingUserName   X X    
SheetCollate X X X    
Sides X X X    
DateTimeAtCompleted     X    
DateTimeAtCreation     X    
DateTimeAtProcessing     X    
JobImpressionsCompleted     X    
JobKOctetsProcessed     X    
JobMediaSheetsCompleted     X    
JobMessageFromOperator     X    
JobOriginatingUserName     X    
JobState     X    
JobStateReasons
包含零个或更多 --
    X    
-- JobStateReason          
NumberOfDocuments     X    
NumberOfInterveningJobs     X    
OutputDeviceAssigned     X    
ColorSupported       X  
PagesPerMinute       X  
PagesPerMinuteColor       X  
PDLOverrideSupported       X  
PrinterIsAcceptingJobs       X  
PrinterInfo       X  
PrinterLocation       X  
PrinterMessageFromOperator       X  
PrinterMakeAndModel       X  
PrinterMoreInfo       X  
PrinterMoreInfoManufacturer       X  
PrinterName       X  
PrinterState       X  
PrinterStateReasons
包含零个或更多 --
      X  
-- PrinterStateReason          
-- Severity          
QueuedJobCount       X  
ReferenceUriSchemesSupported          

请注意:在 javax.print API 中,只有方法中显式地记录 null 引用具有有意义的解释时,方法的 null 引用参数才是正确的。否则使用 null 引用参数是错误的编码,并且可能会导致立即或稍后出现运行时异常。IllegalArgumentException 和 NullPointerException 是此类情形下典型和可接受的运行时异常示例。

从以下版本开始:
1.4

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策