モジュール java.desktop
パッケージ 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属性の名前を示します。

関連項目:
直列化された形式

  • コンストラクタの詳細

    • 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
      戻り値:
      objectがこのプリンタ解像度属性と等しい場合はtrue、それ以外の場合はfalse
      関連項目:
      Object.hashCode()、HashMap

    • getCategory

      public final Class<? extends Attribute> getCategory()
      この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

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

      定義:
      getCategory、インタフェース: Attribute
      戻り値:
      印刷属性クラス(category)、クラスjava.lang.Classのインスタンス

    • getName

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

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

      定義:
      getName、インタフェース: Attribute
      戻り値:
      属性カテゴリ名