javax.print.attribute.standard

クラスPrinterResolution

java.lang.Object

javax.print.attribute.ResolutionSyntax

javax.print.attribute.standard.PrinterResolution

すべての実装されたインタフェース:

Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute

public final class PrinterResolution
extends ResolutionSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

PrinterResolutionは、プリンタがサポートしているか、または印刷ジョブが使用する正確な解像度を指定する印刷属性クラスです。この属性は、プリンタが実際に使用可能なデバイスの解像度が、連続体ではない限られた値セットであることを想定しています。

PrinterResolutionには複数の用途があります。

1. クライアントが要求する解像度を正確にサポートするプリンタを検索し、それ以外の解像度のプリンタを対象外にする時には、クライアントが要求する正確な解像度を示す、PrinterResolutionクラスのインスタンスを指定。この解像度を正確にサポートするプリンタだけが検索対象となる

2. クライアントが要求する正確な解像度を使用してジョブの印刷を実行し、それ以外の解像度では印刷しないようにする時には、PrinterResolutionクラスのインスタンスを印刷ジョブの属性として指定。印刷ジョブが正確な解像度をサポートせず、Fidelityがtrueに設定されている場合、ジョブはエラーになる

要求されている最小の解像度よりも高い解像度をサポートするプリンタをクライアント側で指定する場合は、この属性を検索要求から除外し、サポートされている解像度を直接照会し、クライアントの要求を満たすために最適な解像度を指定。解像度の制御にも使用されるPrintQuality属性を指定するほうがロジックが単純になる場合もある

IPP互換性: PrinterResolutionオブジェクトのメソッドを呼び出すことにより、IPPの"printer-resolution"属性構築に必要な情報を取得できます。getName()によって返されるカテゴリ名はIPP属性の名前を示します。

関連項目:

直列化された形式

フィールドのサマリー

クラス javax.print.attribute.ResolutionSyntaxから継承されたフィールド

DPCM, DPI

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
PrinterResolution(int crossFeedResolution, int feedResolution, int units) 指定された項目を使用して新しいプリンタ解像度属性を構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	equals(Object object) このプリンタ解像度属性がオブジェクトで渡されるものと同等かどうかを返します。
Class<? extends Attribute>	getCategory() この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
String	getName() 属性値がインスタンスとなるカテゴリの名前を返します。

クラス javax.print.attribute.ResolutionSyntaxから継承されたメソッド

getCrossFeedResolution, getCrossFeedResolutionDphi, getFeedResolution, getFeedResolutionDphi, getResolution, hashCode, lessThanOrEquals, toString, toString

クラス java.lang.Objectから継承されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

PrinterResolution

public PrinterResolution(int crossFeedResolution,
                         int feedResolution,
                         int units)

指定された項目を使用して新しいプリンタ解像度属性を構築します。

パラメータ:

crossFeedResolution - 前後送り方向の解像度。

feedResolution - 送り方向の解像度。

units - 単位変換係数。ResolutionSyntax.DPIやResolutionSyntax.DPCMなど。

例外:

IllegalArgumentException - 非チェック例外。crossFeedResolution < 1またはfeedResolution < 1またはunits < 1の場合にスローされる。

メソッドの詳細

equals

public boolean equals(Object object)

このプリンタ解像度属性がオブジェクトで渡されるものと同等かどうかを返します。次の条件がすべてtrueの場合に同等とみなされます。

1. objectがnullではない。
2. objectがPrinterResolutionクラスのインスタンスである。
3. この属性の前後送り方向の解像度がobjectの前後送り方向の解像度に等しい。
4. この属性の送り方向の解像度がobjectの送り方向の解像度に等しい。

オーバーライド:

equals、クラス: ResolutionSyntax

パラメータ:

object - 比較対象のオブジェクト。

戻り値:

objectがこのプリンタ解像度属性と等しい場合はtrue、そうでない場合はfalse。

関連項目:

Object.hashCode()、HashMap

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

PrinterResolutionクラスの場合、カテゴリはPrinterResolutionクラス自身です。

定義:

getCategory、インタフェース: Attribute

戻り値:

印刷属性クラス(カテゴリ)、java.lang.Classクラスのインスタンス。

getName

public final String getName()

属性値がインスタンスとなるカテゴリの名前を返します。

PrinterResolutionクラスの場合、カテゴリ名は"printer-resolution"です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前