软件包 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