クラス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属性の名前を示します。

関連項目:

  • フィールドのサマリー

    クラスで宣言されたフィールド ResolutionSyntax

    DPCM, DPI
    修飾子と型
    フィールド
    説明
    static final int
    DPCM
    1センチあたりドット数(dpcm)を示す値です。
    static final int
    DPI
    1インチあたりドット数(dpi)を示す値です。

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

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

  • メソッドのサマリー

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

    クラスで宣言されたメソッド ResolutionSyntax

    getCrossFeedResolution, getCrossFeedResolutionDphi, getFeedResolution, getFeedResolutionDphi, getResolution, hashCode, lessThanOrEquals, toString, toString
    修飾子と型
    メソッド
    説明
    int
    getCrossFeedResolution(int units)
    指定された単位で解像度属性の前後送り方向の解像度を返します。
    protected int
    getCrossFeedResolutionDphi()
    単位dphiで、この解像度属性の前後送り方向の解像度を返します
    int
    getFeedResolution(int units)
    指定された単位で解像度属性の送り方向の解像度を返します。
    protected int
    getFeedResolutionDphi()
    単位dphiで、この解像度属性の送り方向の解像度を返します
    int[]
    getResolution(int units)
    指定された単位で解像度属性の値を返します。
    int
    hashCode()
    この解像度属性のハッシュ・コード値を返します。
    boolean
    lessThanOrEquals(ResolutionSyntax other)
    この解像度属性の値が指定された解像度属性の値より小さいかまたは等しいかどうかを判定します。
    String
    toString()
    この解像度属性の文字列バージョンを返します。
    String
    toString(int units, String unitsName)
    指定された単位で解像度属性の文字列バージョンを返します。

    クラスオブジェクトで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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
      関連項目:

    • 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
      戻り値:
      属性カテゴリ名