クラスMediaSize

java.lang.Object
javax.print.attribute.Size2DSyntax
javax.print.attribute.standard.MediaSize
すべての実装されたインタフェース:
Serializable, Cloneable, Attribute
public class MediaSize extends Size2DSyntax implements Attribute
クラスMediaSizeは、下端に沿って実行されるXディメンションと左端に沿って実行されるYディメンションを持つ、縦向きの媒体のディメンションを示す2ディメンションのサイズの値を持つ印刷属性クラスです。 したがって、YディメンションはXディメンション以上でなければなりません。 MediaSizeクラスは、ISO、JIS、北米、エンジニアリング、およびその他のメディア用にネストされたクラスに編成された、多くの標準メディア・サイズ値を宣言します。

MediaSizeはまだメディアを指定するために使用されていません。 現在の役割は指定された媒体へのマッピングです(MediaSizeNameを参照)。 クライアントはマッピング・メソッドMediaSize.getMediaSizeForName(MediaSizeName)を使用して、このAPIで列挙されたMediaSizeNameインスタンスの物理的なサイズを見つけることができます。 このメソッドはこの情報を印刷の書式設定とページ作成に使用するクライアントで有効です。

関連項目:

  • ネストされたクラスのサマリー

    ネストされたクラス
    修飾子と型
    クラス
    説明
    static final class 
    MediaSize.Engineering
    クラスMediaSize.Engineeringには、エンジニアリング・メディアのMediaSize値が含まれます。
    static final class 
    MediaSize.ISO
    クラスMediaSize.ISOには、ISOメディアのMediaSize値が含まれています。
    static final class 
    MediaSize.JIS
    クラスMediaSize.JISには、JIS (日本語)メディアのMediaSize値が含まれています。
    static final class 
    MediaSize.NA
    クラスMediaSize.NAには、北アメリカのメディアのMediaSize値が含まれています。
    static final class 
    MediaSize.Other
    クラスMediaSize.Otherには、その他のメディアのMediaSize値が含まれています。

  • フィールドのサマリー

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

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

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

    コンストラクタ
    コンストラクタ
    説明
    MediaSize(float x, float y, int units)
    指定された浮動小数点値を使用して新しい媒体サイズ属性を構築します。
    MediaSize(float x, float y, int units, MediaSizeName media)
    指定された浮動小数点値を使用して新しい媒体サイズ属性を構築します。
    MediaSize(int x, int y, int units)
    指定された整数値を使用して新しい媒体サイズ属性を構築します。
    MediaSize(int x, int y, int units, MediaSizeName media)
    指定された整数値を使用して新しい媒体サイズ属性を構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    equals(Object object)
    この媒体サイズ属性がオブジェクトで渡されるものと一致するかどうかを返します。
    static MediaSizeName
    findMedia(float x, float y, int units)
    指定されたディメンションは、すべての標準MediaSizeインスタンスの中から一致するMediaSizeインスタンスを見つけるために使用されます。
    final Class<? extends Attribute>
    getCategory()
    この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
    static MediaSize
    getMediaSizeForName(MediaSizeName media)
    指定された名前のメディアのMediaSizeを取得します。
    MediaSizeName
    getMediaSizeName()
    このサイズに対応する媒体が存在する場合、その名称を返します。
    final String
    getName()
    属性値がインスタンスとなるカテゴリの名前を返します。

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

    getSize, getX, getXMicrometers, getY, getYMicrometers, hashCode, toString, toString
    修飾子と型
    メソッド
    説明
    float[]
    getSize(int units)
    浮動小数点の値として指定された単位で、この2次元のサイズの属性の寸法を返します。
    float
    getX(int units)
    指定された単位内のこの2次元サイズ属性のXディメンションを浮動小数点値として返します。
    protected int
    getXMicrometers()
    この2次元サイズ属性のXディメンションをマイクロ・メートル(µm)単位で返します。
    float
    getY(int units)
    指定された単位内のこの2次元サイズ属性のYディメンションを浮動小数点値として返します。
    protected int
    getYMicrometers()
    この2次元サイズ属性のYディメンションをマイクロ・メートル(µm)単位で返します。
    int
    hashCode()
    この2次元のサイズの属性のハッシュ・コード値を返します。
    String
    toString()
    この2次元のサイズの属性の文字列バージョンを返します。
    String
    toString(int units, String unitsName)
    この2次元のサイズの属性の文字列バージョンを指定された単位で返します。

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

    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であるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • MediaSize

      public MediaSize(float x, float y, int units)
      指定された浮動小数点値を使用して新しい媒体サイズ属性を構築します。
      パラメータ:
      x - Xディメンション
      y - Yディメンション
      units - 単位換算係数、例えばSize2DSyntax.INCHまたはSize2DSyntax.MM
      スロー:
      IllegalArgumentException - x < 0またはy < 0またはunits < 1またはx > y

    • MediaSize

      public MediaSize(int x, int y, int units)
      指定された整数値を使用して新しい媒体サイズ属性を構築します。
      パラメータ:
      x - Xディメンション
      y - Yディメンション
      units - 単位換算係数、例えばSize2DSyntax.INCHまたはSize2DSyntax.MM
      スロー:
      IllegalArgumentException - x < 0またはy < 0またはunits < 1またはx > y

    • MediaSize

      public MediaSize(float x, float y, int units, MediaSizeName media)
      指定された浮動小数点値を使用して新しい媒体サイズ属性を構築します。
      パラメータ:
      x - Xディメンション
      y - Yディメンション
      units - 単位換算係数、例えばSize2DSyntax.INCHまたはSize2DSyntax.MM
      media - このMediaSizeに関連付けるメディア名
      スロー:
      IllegalArgumentException - x < 0またはy < 0またはunits < 1またはx > y

    • MediaSize

      public MediaSize(int x, int y, int units, MediaSizeName media)
      指定された整数値を使用して新しい媒体サイズ属性を構築します。
      パラメータ:
      x - Xディメンション
      y - Yディメンション
      units - 単位換算係数、例えばSize2DSyntax.INCHまたはSize2DSyntax.MM
      media - このMediaSizeに関連付けるメディア名
      スロー:
      IllegalArgumentException - x < 0またはy < 0またはunits < 1またはx > y

  • メソッドの詳細

    • getMediaSizeName

      public MediaSizeName getMediaSizeName()
      このサイズに対応する媒体が存在する場合、その名称を返します。
      戻り値:
      このメディア・サイズの名前、またはこのサイズに名前が関連付けられていない場合はnull (匿名サイズ)

    • getMediaSizeForName

      public static MediaSize getMediaSizeForName(MediaSizeName media)
      指定された名前のメディアのMediaSizeを取得します。
      パラメータ:
      media - サイズが求められているメディアの名前
      戻り値:
      メディアのサイズ、またはこのメディアがどのサイズにも関連付けられていない場合はnull

    • findMedia

      public static MediaSizeName findMedia(float x, float y, int units)
      指定されたディメンションは、すべての標準MediaSizeインスタンスの中から一致するMediaSizeインスタンスを見つけるために使用されます。 一致するものがない場合は一番近いものが使用されます。

      次に、MediaSizeを使用して、MediaSizeNameオブジェクトを検索します。 最も近い一致するMediaSizeに対応するMediaインスタンスがない場合、このメソッドはnullを返します。

      このメソッドは、ディメンションのみを持つクライアントで、ディメンションに対応するMediaを検索する場合に便利です。

      パラメータ:
      x - Xディメンション
      y - Yディメンション
      units - 単位換算係数、例えばSize2DSyntax.INCHまたはSize2DSyntax.MM
      戻り値:
      これらのディメンションに一致するMediaSizeName、またはnull
      スロー:
      IllegalArgumentException - x <= 0、y <= 0、またはunits < 1の場合

    • equals

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

    • getCategory

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

      クラスMediaSizeおよびベンダー定義のサブクラスの場合、カテゴリはクラスMediaSize自体です。

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

    • getName

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

      クラスMediaSizeおよびベンダー定義のサブクラスでは、カテゴリ名は"media-size"です。

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