- すべての実装されたインタフェース:
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属性ではありません。
- 関連項目:
- 直列化された形式
-
フィールドのサマリー
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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)
この矩形サイズ属性を指定された単位で、文字列形式で返します。
-
フィールド詳細
-
コンストラクタの詳細
-
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の場合に同等とみなされます。object
はnull
ではありません。object
はMediaPrintableArea
クラスのインスタンスです。- 原点と寸法が同じである
- オーバーライド:
equals
、クラス:Object
- パラメータ:
object
- 比較するObject
- 戻り値:
true
、object
がこのメディア・マージン属性に相当する場合、それ以外の場合はfalse
- 関連項目:
Object.hashCode()
、HashMap
-
getCategory
この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。クラス
MediaPrintableArea
の場合、カテゴリはクラスMediaPrintableArea
自体です。- 定義:
getCategory
、インタフェース:Attribute
- 戻り値:
- 印刷属性クラス(category)、クラス
java.lang.Class
のインスタンス
-
getName
public final String getName()属性値がインスタンスとなるカテゴリの名前を返します。クラス
MediaPrintableArea
の場合、カテゴリ名は"media-printable-area"
です。これはIPP V1.1属性ではありません。
-
toString
この矩形サイズ属性を指定された単位で、文字列形式で返します。- パラメータ:
units
- 単位変換係数、たとえばINCH
またはMM
unitsName
- ユニット名文字列、例えば"in"
または"mm"
。null
の場合、ユニット名は結果に追加されません- 戻り値:
- この2ディメンションのサイズ属性の文字列バージョン
- 例外:
IllegalArgumentException
-units < 1
の場合
-
toString
public String toString()この矩形サイズ属性をmm単位で、文字列形式で返します。 -
hashCode
public int hashCode()この属性のハッシュ・コード値を返します。- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-