モジュール java.desktop
パッケージ javax.print.attribute.standard

クラスNumberUp

  • すべての実装されたインタフェース:
    Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute
    public final class NumberUp
extends IntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
    クラスNumberUpは、選択されたメディアのインスタンスの片面に適用される印刷ストリーム・ページの数を指定する整数値の印刷属性クラスです。 つまり、NumberUp値がnの場合、出力ストリームのnページを選択された媒体の片面にまとめて印刷します。 これを可能にするため、変形、スケーリング、および回転をプリンタ側で行う場合があります。 この属性は主に出力ストリーム・ページの変形、スケーリング、および回転を制御します。

    マルチ・ジョブ印刷ジョブ(複数の書類を持つジョブ)でのNumberUp属性の効果は、すべてのドキュメントに指定された同じ番号の値があるかどうか、または異なるドキュメントの番号の値が異なるかどうか、MultipleDocumentHandling属性の(おそらくデフォルト)の値によって異なります。

    • すべてのドキュメントで縮小印刷数値nが指定されている場合、MultipleDocumentHandlingのいずれかの値が意味を持ち、プリンタの処理は、次のようにMultipleDocumentHandlingの値によって決まります。
      • SINGLE_DOCUMENT -- すべての入力ドキュメントは、1つの出力ドキュメントにまとめられます。 用紙には出力ドキュメントの出力ストリームがnmページまとめて印刷されます。
      • SINGLE_DOCUMENT_NEW_SHEET -- すべての入力ドキュメントは、1つの出力ドキュメントにまとめられます。 用紙には出力ドキュメントの出力ストリームがnページまとめて印刷されます。 各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。
      • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 入力ドキュメントは別々のままです。 用紙には入力ドキュメントの出力ストリームがnページまとめて印刷されます。 入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。
      • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 入力ドキュメントは別々のままです。 用紙には入力ドキュメントの出力ストリームがnページまとめて印刷されます。 入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。
      • SINGLE_DOCUMENT -- すべての入力ドキュメントは、1つの出力ドキュメントにまとめられます。 用紙には、出力ドキュメントの出力ストリームがniページまとめて印刷されます。ここでiは出力ドキュメント内のその時点での入力ドキュメント番号になります。 次の入力ドキュメントの縮小印刷数が異なる場合は、その出力ストリームの最初のページは、新しい用紙に印刷されます。この場合、その前の用紙にまとめて印刷される出力ストリームのページ数は、指定の値よりも少なくなります。
      • SINGLE_DOCUMENT_NEW_SHEET -- すべての入力ドキュメントは、1つの出力ドキュメントにまとめられます。 用紙には出力ドキュメントの出力ストリームがnページまとめて印刷されます。 各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はnよりも少なくなります。
      • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 入力ドキュメントは別々のままです。 入力ドキュメントiに関して、用紙には入力ドキュメントの出力ストリームがniページまとめて印刷されます。 入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はniよりも少なくなります。
      • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 入力ドキュメントは別々のままです。 入力ドキュメントiに関して、用紙には入力ドキュメントの出力ストリームがniページまとめて印刷されます。 入力ドキュメントが個別に処理されるため、各入力ドキュメントの最初の印刷データは必ず新しい用紙に印刷されます。したがって、入力ドキュメントの最後の印刷データにまとめて印刷される出力ストリームのページ数はniよりも少なくなります。
    IPP互換性: 整数値はIPP整数値を示します。 getName()によって返されるカテゴリ名はIPP属性の名前を示します。

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

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

      コンストラクタ 
      コンストラクタ 説明
      NumberUp​(int value)
      指定された整数値を使用して新しい縮小印刷数属性を構築します。

    • メソッドのサマリー

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

    • コンストラクタの詳細

      • NumberUp

        public NumberUp​(int value)
        指定された整数値を使用して新しい縮小印刷数属性を構築します。
        パラメータ:
        value - 整数値
        例外:
        IllegalArgumentException - value < 1の場合

    • メソッドの詳細

      • equals

        public boolean equals​(Object object)
        この縮小印刷数属性がオブジェクトで渡されるものと一致するかどうかを返します。 次の条件がすべてtrueの場合に同等とみなされます。
        1. objectはnullではありません。
        2. objectはNumberUpクラスのインスタンスです。
        3. この縮小印刷数属性の値とobjectの値が一致する。
        オーバーライド:
        equals、クラス: IntegerSyntax
        パラメータ:
        object - 比較するObject
        戻り値:
        true objectがこの番号up属性に相当する場合、それ以外の場合はfalse
        関連項目:
        Object.hashCode()、HashMap

      • getCategory

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

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

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

      • getName

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

        クラスNumberUpの場合、カテゴリ名は"number-up"です。

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