軟體套件 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 類別是整數值形式的列印屬性類別，它指定了到目前為止全部作業的已完成標記和堆疊(stack)空間的介質紙張數，不管這些紙張完成的是單面處理還是雙面處理。
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