モジュール java.desktop
パッケージ 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
        戻り値:
        属性クラス(カテゴリ)の出力、クラスjava.lang.Classのインスタンス

      • getName

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

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

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