パッケージ javax.print.attribute.standard
javax.print.attribute.standard
には、特定の印刷属性のクラスが含まれています。 親パッケージのjavax.print.attributeは、Java Print Serviceの属性の型とそれらが属性セットに収集される方法を記述するクラスとインタフェースを提供します。
属性は印刷サービスが提供可能な印刷機能を表します。 印刷サービスがすべての属性をサポートする保証はありません。 サポートされる属性の値についても、そのすべてをサポートする保証はありません。
API側では特定の属性のサポートを必須としますが、それ以外はオプションであり、サポートするかどうかはサービス側で選択できます。 受け入れ可能な値は属性によって異なり、特定の属性に対して特定の値が必須になります。 それ以外の属性値は属性自体と同様にオプションであり、サポートするかどうかはサービス側で選択できます。 これらのサポート条件は各属性クラスのドキュメントに記述されます。
パッケージjavax.print.attribute.standard
には、標準の印刷属性と、印刷ドメインで広く使用されている標準の印刷属性値が含まれています。 印刷サービスのベンダーは、標準の属性に加えて、ベンダー固有の印刷属性を提供できます。 またたとえば、サブクラスで標準印刷属性にベンダー固有の値を追加することで、拡張できます。 クライアント側でこのような追加属性や拡張属性を使用可能にするためには、ベンダーは新しい属性クラスを公開する必要があります。
多くの標準属性クラスは、javax.print.attribute
パッケージの抽象構文クラスの1つを拡張します。 これらの抽象構文クラスは、それぞれ異なる型を表します。 たとえばEnumSyntaxクラスは、型保証された列挙を表します。 抽象構文クラスは属性値のラッパーを提供します。
属性クラスがEnumSyntax
を拡張し、属性の値がIPP互換の場合、属性のtoString
メソッドは属性値のIPP文字列表現を返します。たとえばJobState属性には「processing-stopped」のような値が返されます。 ただしEnumSyntax
クラスは拡張可能であるため、ベンダー独自の属性値を定義できます。 属性がEnumSyntax
クラスを使用し、これらのベンダー定義の値の1つに設定される場合、toString
メソッドは値のIPP文字列表現を返しません。
印刷クライアント・アプリケーションは、通常javax.print.attribute.standardパッケージのすべての印刷属性クラスを使用する必要はなく、アプリケーション関連のものだけを使用します。
パッケージjavax.print.attribute.standard
の属性クラスは、インターネットRFC文書、2000年9月の「RFC 2911インターネット印刷プロトコル/1.1: モデルとセマンティクス」で定義されているインターネット印刷プロトコルの(IPP)属性に基づいています。 詳細は、RFC 2911を参照してください。 各属性クラスの説明は主に上記のドキュメントからの引用です。 これらのドキュメントの作者にこの場を借りて感謝いたします。
属性の構成
印刷属性には、ドキュメント属性、印刷要求属性、印刷ジョブ属性、印刷サービス属性、サポート値属性の5種類があります。ドキュメント属性
ドキュメント属性は個々のドキュメント、およびそのドキュメントに適用される印刷ジョブ設定を指定します。 ドキュメント属性クラスはDocAttributeインタフェースを実装します。 ドキュメント属性はDocAttributeSetで使用できます。印刷要求属性
印刷要求属性は、印刷ジョブ全体、およびそのジョブのすべてのドキュメントに適用される設定を指定します。 印刷要求属性クラスはPrintRequestAttributeインタフェースを実装します。 印刷リクエスト属性は、PrintRequestAttributeSetに表示されます。ドキュメント属性ではあっても印刷要求属性ではない属性があり、このような属性はドキュメント・レベルだけで指定できます。 逆に印刷要求属性ではあってもドキュメント属性ではない属性もあり、このような属性は印刷要求レベルだけで指定できます。 どちらでも指定できる属性もあります。
属性をドキュメント・レベルで指定すると、属性はそのドキュメントだけに適用されます。 印刷要求レベルで指定すると、ジョブ全体、そのジョブに含まれるすべてのドキュメントに適用されます。 両方に指定されている場合、ドキュメント・レベルの属性が印刷要求レベルで同じカテゴリに指定された属性をオーバーライドします。
印刷ジョブ属性
印刷ジョブ属性は印刷ジョブのステータスを通知します。 印刷ジョブ属性クラスは PrintJobAttributeインタフェースを実装します。 印刷ジョブ属性は、PrintJobAttributeSetに表示されます。印刷要求属性および印刷ジョブ属性のどちらとしても指定可能な属性があります。このような属性を印刷要求に追加すると、それ以降の印刷ジョブの特性を指定できます。これらの属性は印刷ジョブの属性セットにも指定されます。 印刷ジョブ属性ではあっても印刷要求属性ではない属性は、印刷サービス自体によって印刷ジョブの属性セットに追加されます。
印刷サービス属性
印刷サービス属性は印刷サービスのステータスを通知します。 印刷サービス属性クラスはインタフェースPrintServiceAttributeを実装します。 印刷サービス属性はPrintServiceAttributeSetで使用できます。サポート値属性
サポート値属性は、印刷サービスがサポートしている、別の属性に対する正当な値を示します。 サポート値属性クラスはSupportedValuesAttributeインタフェースを実装します。 ただし、サポートされている値の属性は属性セットには表示されないため、制限されたAttributeSetサブ・インタフェースはありません。属性表
次の表はすべての印刷属性のリストです。 Attributeインタフェースに加えて、各属性クラスが実装するタグ機能インタフェースも記載され、APIでの各属性の使用方法を示しています。 印刷サービスが、各ドキュメント属性と印刷要求属性の属性カテゴリに対してサポートしている値を示す、サポート値属性クラスがある場合は、SupportedValuesAttribute列に表示されます。
ご注意ください: javax.print
APIでは、メソッドに明示的に記述されていない限り、メソッドへのnull
参照パラメータが正しくありません。 これに反する使用は無効なコーディングであり、すぐにまたはあとで実行時の例外が生ずる結果になります。 IllegalArgumentException
およびNullPointerException
は、そのような場合の一般的で許容される実行時例外の例です。
- 導入されたバージョン:
- 1.4
-
クラスのサマリー クラス 説明 Chromaticity クラスChromaticity
は、モノクロまたはカラー印刷を指定する列挙型の印刷属性クラスです。ColorSupported ColorSupported
クラスは、ハイライト・カラーおよびフル・プロセス・カラーを含め、デバイスが何らかのタイプのカラー印刷を実行できるかどうかを識別する列挙型の印刷属性クラスです。Compression クラスCompression
は、印刷データの圧縮方法を指定する列挙型の印刷属性クラスです。Copies クラスCopies
は、印刷するコピー数を指定する整数値の印刷属性クラスです。CopiesSupported クラスCopiesSupported
は、Copies
属性でサポートされている値を与える整数のセットである印刷属性クラスです。DateTimeAtCompleted クラスDateTimeAtCompleted
は、印刷ジョブが完了した日時を示す日時属性の印刷属性クラスです。(または取消または中止された)。DateTimeAtCreation クラスDateTimeAtCreation
は、印刷ジョブが作成された日時を示す日時属性の印刷属性クラスです。DateTimeAtProcessing クラスDateTimeAtProcessing
は、印刷ジョブが最初に処理を開始した日時を示す日時属性の印刷属性クラスです。Destination クラスDestination
は、スプールされたプリンタのフォーマットされたデータの代替宛先を示すために使用される印刷属性クラス、URI
です。DialogOwner 印刷またはページ設定のダイアログのリクエストをサポートするために使用される属性クラスは、すべてのウィンドウまたは特定のウィンドウの上に表示されます。DialogTypeSelection クラスDialogTypeSelection
は、印刷オプションを指定するために使用されるユーザー・ダイアログ・タイプを示す列挙型の印刷属性クラスです。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 クラスJobMediaSheetsSupported
は、JobMediaSheets
属性でサポートされている値を与える整数のセットである印刷属性クラスです。JobMessageFromOperator クラスJobMessageFromOperator
は、オペレータ、システム管理者、または"intelligent"プロセスからのメッセージを提供して、ジョブに対して行われた変更またはその他の管理アクションの理由をエンドユーザーに示す、印刷属性クラス(テキスト属性)です。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
ディメンションを持つ、縦向きの媒体のディメンションを示す2ディメンションのサイズの値を持つ印刷属性クラスです。MediaSize.Engineering クラスMediaSize.Engineering
には、エンジニアリング・メディアのMediaSize
値が含まれます。MediaSize.ISO クラスMediaSize.ISO
には、ISOメディアのMediaSize
値が含まれています。MediaSize.JIS クラスMediaSize.JIS
には、JIS (日本語)メディアのMediaSize
値が含まれています。MediaSize.NA クラスMediaSize.NA
には、北アメリカのメディアのMediaSize
値が含まれています。MediaSize.Other クラスMediaSize.Other
には、その他のメディアのMediaSize
値が含まれています。MediaSizeName クラスMediaSizeName
は、Media
のサブクラスです。MediaTray クラスMediaTray
は、Media
のサブクラスです。MultipleDocumentHandling MultipleDocumentHandling
クラスは、終了操作、および1つ以上の印刷ストリーム・ページのインプレッションとメディア・シートへの配置を制御する列挙型の印刷属性クラスです。NumberOfDocuments クラスNumberOfDocuments
は、ドキュメント印刷データがプリンタに到達したかどうかにかかわらず、プリンタがこのジョブに対して受け入れた個々のドキュメントの数を示す整数値の印刷属性です。NumberOfInterveningJobs クラスNumberOfInterveningJobs
は、(すなわち、現在の予定されたオーダー)を完了するのに必要な時間の相対的な時間順にこのジョブより先行するジョブの数を示す整数値の印刷属性です。NumberUp クラスNumberUp
は、選択されたメディアのインスタンスの片面に適用される印刷ストリーム・ページの数を指定する整数値の印刷属性クラスです。NumberUpSupported クラスNumberUpSupported
は、NumberUp
属性でサポートされている値を与える整数のセットである印刷属性クラスです。OrientationRequested クラスOrientationRequested
は、印刷された印刷ストリーム・ページの望ましい方向を示す列挙型の印刷属性クラスです。クライアントが提供する印刷ストリーム・ページの方向は記述されていません。OutputDeviceAssigned クラスOutputDeviceAssigned
は、サービスがこのジョブを割り当てた出力デバイスを識別するテキスト属性の印刷属性クラスです。PageRanges クラスPageRanges
は、印刷される各文書の各コピーに対してPrinterオブジェクトが使用する印刷ストリーム・ページの範囲を識別する印刷属性クラスであり、整数のセットです。PagesPerMinute クラスPagesPerMinute
は、このプリンタ(e.g., simplex, black-and-white)によって生成される可能性のある最も近い整数に対する1分あたりの公称ページ数を示す整数値の印刷属性です。PagesPerMinuteColor クラスPagesPerMinuteColor
は、色を印刷するときにこのプリンタによって生成される可能性のある、最も近い整数に対する1分あたりの公称ページ数を示す整数値の印刷属性です。(例:シン・プレックス、カラー)。PDLOverrideSupported PDLOverrideSupported
クラスは、ドキュメントの印刷データに埋め込まれた処理命令を、印刷データ外の属性として指定された処理命令でオーバーライドしようとするプリンタ機能を表す列挙型の印刷属性クラスです。PresentationDirection PresentationDirection
クラスは、NumberUp
属性と組み合わせて使用される列挙型の印刷属性クラスで、選択されたメディアのインスタンスの片面に適用される複数の印刷ストリーム・ページのレイアウトを示します。PrinterInfo クラスPrinterInfo
は、プリンタに関する記述情報を提供するテキスト属性の印刷属性クラスです。PrinterIsAcceptingJobs クラスPrinterIsAcceptingJobs
は、プリンタが現在ジョブを受け入れることができるかどうかを示す列挙型の印刷属性クラスです。PrinterLocation クラスPrinterLocation
は、デバイスのロケーションを識別するテキスト属性の印刷属性クラスです。PrinterMakeAndModel クラスPrinterMakeAndModel
は、プリンタの製造元とモデルである印刷属性クラス、テキスト属性です。PrinterMessageFromOperator クラスPrinterMessageFromOperator
は、オペレータ、システム管理者、または"intelligent"プロセスから、プリンタが使用できない理由や使用状況などの情報をエンド・ユーザーに示すメッセージを提供する印刷属性クラス、テキスト属性です利用可能であると予想されます。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
は、PENDING
、PENDING_HELD
、PROCESSING
、またはPROCESSING_STOPPED
のいずれかであるプリンタ内のジョブの数を示す整数値の印刷属性です。ReferenceUriSchemesSupported クラスReferenceUriSchemesSupported
は、プリンタがURI
のロケーションに格納されている印刷データを取得するために使用できる"http:"や"ftp:"などの"URIスキーム、"を示す列挙型の印刷属性クラスです。RequestingUserName クラスRequestingUserName
は、印刷ジョブを送信したエンド・ユーザーの名前を指定するテキスト属性の印刷属性クラスです。Severity クラスSeverity
は、PrinterStateReason
属性の重大度を示す列挙型の印刷属性クラスです。SheetCollate クラスSheetCollate
は、Copies
属性でドキュメントの複数のコピーが指定されている場合、ジョブ内の各印刷ドキュメントの各コピーのメディア・シートを順番に並べるかどうかを指定する列挙型の印刷属性クラスです。Sides Sides
クラスは、選択されたメディア(インプレッション)のインスタンスの側面に印刷ストリーム・ページをどのように適用するかを指定する列挙型の印刷属性クラスです。