javax.print.attribute.standard

クラス DocumentName

java.lang.Object

javax.print.attribute.TextSyntax

javax.print.attribute.standard.DocumentName

すべての実装されたインタフェース:

Serializable, Cloneable, Attribute, DocAttribute

public final class DocumentName
extends TextSyntax
implements DocAttribute

DocumentName クラスは、ドキュメントの名前を指定するテキスト属性の印刷属性クラスです。DocumentName は印刷データ (ドキュメント) の属性であり、Print Job の属性ではありません。ドキュメントの名前は、クライアントによって定義される任意の文字列です。ただし、JobName が指定されない場合、代わりに DocumentName が使用されます。これは、DocumentName をサポートする仕様で、JobName の報告が必要になることを意味します。また逆の場合も同じです。詳細は、JobName を参照してください。

IPP 互換性: 文字列の値は IPP 名の値を示します。ロケールは IPP の言語を示します。getName() によって返されるカテゴリ名は IPP 属性の名前を示します。

関連項目:

直列化された形式

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

コンストラクタ

コンストラクタと説明
DocumentName(String documentName, Locale locale) 指定されたドキュメントの名前とロケールで、新しいドキュメントの名前属性を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	equals(Object object) このドキュメントの名前属性がオブジェクトに渡された属性と等しいかどうかを返します。
Class<? extends Attribute>	getCategory() この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
String	getName() 属性値がインスタンスとなるカテゴリの名前を返します。

クラス javax.print.attribute.TextSyntax から継承されたメソッド

getLocale, getValue, hashCode, toString

クラス java.lang.Object から継承されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

DocumentName

public DocumentName(String documentName,
            Locale locale)

指定されたドキュメントの名前とロケールで、新しいドキュメントの名前属性を構築します。

パラメータ:

documentName - ドキュメントの名前。

locale - テキスト文字列の言語。null は、Locale.getDefault() によって返されるデフォルトのロケールを示すと解釈されます

例外:

NullPointerException - 非チェック例外。documentName が null の場合にスローされます。

メソッドの詳細

equals

public boolean equals(Object object)

このドキュメントの名前属性がオブジェクトに渡された属性と等しいかどうかを返します。次の条件がすべて true の場合に同等とみなされます。

1. object が null ではない。
2. object が DocumentName クラスのインスタンスである。
3. このドキュメントの名前属性の基になる文字列と object の基になる文字列が同じである。
4. このドキュメントの名前属性のロケールと object のロケールが同じである。

オーバーライド:

equals、クラス: TextSyntax

パラメータ:

object - 比較対象のオブジェクト。

戻り値:

object がこのドキュメントの名前属性と等しい場合は true、そうでない場合は false。

関連項目:

Object.hashCode()、HashMap

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

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

定義:

getCategory、インタフェース: Attribute

戻り値:

印刷属性クラス (カテゴリ)、java.lang.Class クラスのインスタンス。

getName

public final String getName()

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

DocumentName クラスの場合、カテゴリ名は "document-name" です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前