モジュール java.desktop

パッケージ javax.print.attribute.standard

クラスMediaPrintableArea

java.lang.Object

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)	この矩形サイズ属性を指定された単位で、文字列形式で返します。

クラス java.lang.Objectで宣言されたメソッド

clone、finalize、getClass、notify、notifyAll、wait、wait、wait

フィールドの詳細

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、それ以外の場合は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

戻り値:

このオブジェクトの文字列表現。

hashCode

public int hashCode()

この属性のハッシュ・コード値を返します。

オーバーライド:

hashCode 、クラス: Object

戻り値:

このオブジェクトのハッシュ・コード値。

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)