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

クラスMediaPrintableArea

  • すべての実装されたインタフェース:
    Serializable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute
    public final class MediaPrintableArea
extends Object
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
    クラスMediaPrintableAreaは、メディアの印刷可能領域と印刷不能領域を区別するために使用される印刷属性です。

    印刷可能領域は媒体の寸法内に収まる矩形として指定します。

    ほとんどのプリンタにはハードウェア上の制限があり、媒体の表面全体に印刷することはできません。 このクラスは印刷ジョブの許容値照会、印刷ジョブで使用できる印刷可能領域の制限内での領域要求に使用できます。

    印刷可能領域を照会する場合、クライアント側で適切なコンテキストを提供する必要があります。 少なくとも使用する媒体のサイズが指定されていなければ、印刷可能領域として有効な値を取得することはできません。

    この属性は用紙の端からの距離としては記述されません。この理由の1つとしてあげられるのは、この属性は特定の媒体と関連したものであることを強調するためです。この属性は他の属性選択のコンテキスト内で記述する必要があります。 またクライアント側の処理も印刷可能領域を指定するほうが通常は容易になります。

    ハードウェアの最小マージンはプリンタのプロパティだけでなく、媒体のサイズ、方向、タイプ、および指定された仕上げなどの影響を受けます。 PrintServiceが提供するメソッドで、適切なコンテキストで属性のサポートされる値を照会できます。PrintService.getSupportedAttributeValues()を参照してください

    矩形の印刷可能領域を決定する場合、要求しているコンテキスト内で指定されている方向に関わらず、ポートレート・モードで印刷する場合の用紙の左上位置が原点となり、その座標(x,y)が設定されます。 たとえばA4サイズ用紙の印刷可能領域は、ポートレート・モードおよびランドスケープ・モードのどちらの場合でも、高さが幅より大きくなります。

    印刷可能領域属性の値は、整数型としてミクロン(µm)単位で内部に格納されます。ここで、1ミクロン= 10-6メートル= 1/1000ミリメートル= 1/25400インチです。 これにより、寸法を1/1000 mm (= 1µm)または1/100インチ(= 254µm)の精度で正確に表すことができます。 小数点以下のインチを2の負のべき乗で表す場合、寸法を1/8インチ(= 3175µm)精度で表すことはできますが、1/16インチ精度で表すことはできません(1/16インチがµmの積分値と一致しないため)。

    IPP互換性: MediaPrintableAreaはIPP属性ではありません。

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

    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      static int INCH
      インチ(in)単位を示す値です。
      static int MM
      ミリメートル(mm)単位を示す値です。

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

      コンストラクタ 
      コンストラクタ 説明
      MediaPrintableArea​(float x, float y, float w, float h, int units)
      浮動小数点値からMediaPrintableAreaオブジェクトを構築します。
      MediaPrintableArea​(int x, int y, int w, int h, int units)
      整数値からMediaPrintableAreaオブジェクトを構築します。

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      boolean equals​(Object object)
      この媒体マージン属性がオブジェクトで渡されるものと一致するかどうかを返します。
      Class<? extends Attribute> getCategory()
      この印刷属性値のカテゴリとして使用される印刷属性クラスを返します。
      float getHeight​(int units)
      指定された単位で印刷可能領域のheightを取得します。
      String getName()
      属性値がインスタンスとなるカテゴリの名前を返します。
      float[] getPrintableArea​(int units)
      印刷可能領域をx, y, w, hの順に4つの値の配列として取得します。
      float getWidth​(int units)
      指定された単位で印刷可能領域のwidthを取得します。
      float getX​(int units)
      指定された単位で、印刷可能領域の原点のxロケーションを取得します。
      float getY​(int units)
      指定された単位で、印刷可能領域の原点のyロケーションを取得します。
      int hashCode()
      この属性のハッシュ・コード値を返します。
      String toString()
      この矩形サイズ属性をmm単位で、文字列形式で返します。
      String toString​(int units, String unitsName)
      この矩形サイズ属性を指定された単位で、文字列形式で返します。

    • フィールドの詳細

      • INCH

        public static final int INCH
        インチ(in)単位を示す値です。 これは、実際にインチに乗算してμm (25400)を算出する変換係数です。
        関連項目:
        定数フィールド値

      • MM

        public static final int MM
        ミリメートル(mm)単位を示す値です。 これは、実際にmmに乗算してμm (1000)を算出する変換係数です。
        関連項目:
        定数フィールド値

    • コンストラクタの詳細

      • MediaPrintableArea

        public MediaPrintableArea​(float x,
                          float y,
                          float w,
                          float h,
                          int units)
        浮動小数点値からMediaPrintableAreaオブジェクトを構築します。
        パラメータ:
        x - 印刷可能領域の原点のx座標
        y - 印刷可能領域の原点のy座標
        w - 印刷可能領域の幅
        h - 印刷可能領域の高さ
        units - 値の単位
        例外:
        IllegalArgumentException - x < 0またはy < 0またはw <= 0またはh <= 0またはunits < 1

      • MediaPrintableArea

        public MediaPrintableArea​(int x,
                          int y,
                          int w,
                          int h,
                          int units)
        整数値からMediaPrintableAreaオブジェクトを構築します。
        パラメータ:
        x - 印刷可能領域の原点のx座標
        y - 印刷可能領域の原点のy座標
        w - 印刷可能領域の幅
        h - 印刷可能領域の高さ
        units - 値の単位
        例外:
        IllegalArgumentException - x < 0またはy < 0またはw <= 0またはh <= 0またはunits < 1

    • メソッドの詳細

      • getPrintableArea

        public float[] getPrintableArea​(int units)
        印刷可能領域をx, y, w, hの順に4つの値の配列として取得します。 指定された単位での値が返されます。
        パラメータ:
        units - 単位変換係数、たとえばINCHまたはMM
        戻り値:
        指定された単位でのx, y, w, hの配列としての印刷可能領域
        例外:
        IllegalArgumentException - units < 1の場合

      • getX

        public float getX​(int units)
        指定された単位で、印刷可能領域の原点のxロケーションを取得します。
        パラメータ:
        units - 単位変換係数、たとえばINCHまたはMM
        戻り値:
        x指定された単位での印刷可能領域の原点のロケーション
        例外:
        IllegalArgumentException - units < 1の場合

      • getY

        public float getY​(int units)
        指定された単位で、印刷可能領域の原点のyロケーションを取得します。
        パラメータ:
        units - 単位変換係数、たとえばINCHまたはMM
        戻り値:
        y指定された単位での印刷可能領域の原点のロケーション
        例外:
        IllegalArgumentException - units < 1の場合

      • getWidth

        public float getWidth​(int units)
        指定された単位で印刷可能領域のwidthを取得します。
        パラメータ:
        units - 単位変換係数、たとえばINCHまたはMM
        戻り値:
        指定された単位の印刷可能領域のwidth
        例外:
        IllegalArgumentException - units < 1の場合

      • getHeight

        public float getHeight​(int units)
        指定された単位で印刷可能領域のheightを取得します。
        パラメータ:
        units - 単位変換係数、たとえばINCHまたはMM
        戻り値:
        指定された単位の印刷可能領域のheight
        例外:
        IllegalArgumentException - units < 1の場合

      • equals

        public boolean equals​(Object object)
        この媒体マージン属性がオブジェクトで渡されるものと一致するかどうかを返します。 次の条件がすべてtrueの場合に同等とみなされます。
        1. objectはnullではありません。
        2. objectはMediaPrintableAreaクラスのインスタンスです。
        3. 原点と寸法が同じである
        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        object - 比較するObject
        戻り値:
        true、objectがこのメディア・マージン属性に相当する場合、それ以外の場合はfalse
        関連項目:
        Object.hashCode()、HashMap

      • getCategory

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

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

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

      • getName

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

        クラスMediaPrintableAreaの場合、カテゴリ名は"media-printable-area"です。

        これはIPP V1.1属性ではありません。

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

      • toString

        public String toString​(int units,
                       String unitsName)
        この矩形サイズ属性を指定された単位で、文字列形式で返します。
        パラメータ:
        units - 単位変換係数、たとえばINCHまたはMM
        unitsName - ユニット名文字列、例えば"in"または"mm"。 nullの場合、ユニット名は結果に追加されません
        戻り値:
        この2ディメンションのサイズ属性の文字列バージョン
        例外:
        IllegalArgumentException - units < 1の場合

      • toString

        public String toString()
        この矩形サイズ属性をmm単位で、文字列形式で返します。
        オーバーライド:
        toString 、クラス:  Object
        戻り値:
        このオブジェクトの文字列表現