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 class
クラスMediaSize.Engineering
には、エンジニアリング・メディアのMediaSize
値が含まれます。static class
クラスMediaSize.ISO
には、ISOメディアのMediaSize
値が含まれています。static class
クラスMediaSize.JIS
には、JIS (日本語)メディアのMediaSize
値が含まれています。static class
クラスMediaSize.NA
には、北アメリカのメディアのMediaSize
値が含まれています。static class
クラスMediaSize.Other
には、その他のメディアのMediaSize
値が含まれています。 -
フィールドのサマリー
クラス javax.print.attribute.Size2DSyntaxで宣言されたフィールド
INCH, 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
この媒体サイズ属性がオブジェクトで渡されるものと一致するかどうかを返します。static MediaSizeName
findMedia(float x, float y, int units)
指定されたディメンションは、すべての標準MediaSize
インスタンスの中から一致するMediaSize
インスタンスを見つけるために使用されます。この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。static MediaSize
getMediaSizeForName(MediaSizeName media)
指定された名前のメディアのMediaSize
を取得します。このサイズに対応する媒体が存在する場合、その名称を返します。getName()
属性値がインスタンスとなるカテゴリの名前を返します。クラス javax.print.attribute.Size2DSyntaxで宣言されたメソッド
getSize, getX, getXMicrometers, getY, getYMicrometers, hashCode, toString, toString
-
コンストラクタの詳細
-
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の場合に同等とみなされます。object
はnull
ではありません。object
はMediaSize
クラスのインスタンスです。- このメディア・サイズ属性
X
ディメンションは、object
のX
ディメンションに等しい。 - このメディア・サイズ属性
Y
ディメンションは、object
のY
ディメンションに等しい。
- オーバーライド:
equals
、クラス:Size2DSyntax
- パラメータ:
object
- 比較するObject
- 戻り値:
true
object
がこのメディア・サイズ属性に相当する場合、それ以外の場合はfalse
- 関連項目:
Object.hashCode()
、HashMap
-
getCategory
この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。クラス
MediaSize
およびベンダー定義のサブクラスの場合、カテゴリはクラスMediaSize
自体です。- 定義:
getCategory
、インタフェース:Attribute
- 戻り値:
- 印刷属性クラス(category)、クラス
java.lang.Class
のインスタンス
-
getName
public final String getName()属性値がインスタンスとなるカテゴリの名前を返します。クラス
MediaSize
およびベンダー定義のサブクラスでは、カテゴリ名は"media-size"
です。
-