javax.print.attribute.standard
クラス DocumentName

java.lang.Object
  |
  +--javax.print.attribute.TextSyntax
        |
        +--javax.print.attribute.standard.DocumentName

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

Attribute, Cloneable, DocAttribute, Serializable

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	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 のロケールが同じである

オーバーライド:

クラス TextSyntax 内の equals

パラメータ:

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

戻り値:

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

getCategory

public final Class getCategory()

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

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

定義:

インタフェース Attribute 内の getCategory

戻り値:

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

getName

public final String getName()

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

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

定義:

インタフェース Attribute 内の getName

戻り値:

属性のカテゴリの名前