com.sun.tools.doclets
インタフェース Taglet

public interface Taglet

ドックレットが使用するカスタムタグのインタフェースです。カスタムタグはこのインタフェースを実装する必要があります。実行時にドックレットがタグレットを読み込んで使用するには、そのタグレットが、次のシグネチャで Map を引数として受け取る、register という static メソッドをもっている必要があります。

   public void register(Map map)
 

タグレットがそれ自体の登録に失敗した場合は、例外をスローすることをお勧めします。スローする例外はユーザ任意です。

2 つのタグレットの例を次に示します。

• ToDoTaglet.java - スタンドアロンタグレット
• UnderlineTaglet.java - インラインタグレット

独自のタグレットの作成方法ついては、「タグレットの概要」を参照してください。 この API の拡張版を、ドックレットツールキットから入手できます。
com.sun.tools.doclets.internal.toolkit.taglets.Taglet.

導入されたバージョン:

1.4

inField

boolean inField()

このタグレットがフィールドドキュメンテーションで使用されている場合、true を返します。インラインタグについては false が設定されます。

戻り値:

このタグレットがフィールドドキュメンテーションで使用されている場合は true、そうでない場合は false を返します。

inConstructor

boolean inConstructor()

このタグレットがコンストラクタドキュメンテーションで使用されている場合、true を返します。インラインタグについては false が設定されます。

戻り値:

このタグレットがコンストラクタドキュメンテーションで使用されている場合は true、そうでない場合は false を返します。

inMethod

boolean inMethod()

このタグレットがメソッドキュメンテーションで使用されている場合、true を返します。インラインタグについては false が設定されます。

戻り値:

このタグレットがメソッドドキュメンテーションで使用されている場合は true、そうでない場合は false を返します。

inOverview

boolean inOverview()

このタグレットが概要ドキュメンテーションで使用されている場合、true を返します。インラインタグについては false が設定されます。

戻り値:

このタグレットがメソッドドキュメンテーションで使用されている場合は true、そうでない場合は false を返します。

inPackage

boolean inPackage()

このタグレットがパッケージドキュメンテーションで使用されている場合、true を返します。インラインタグについては false が設定されます。

戻り値:

このタグレットがパッケージドキュメンテーションで使用されている場合は true、そうでない場合は false を返します。

inType

boolean inType()

このタグレットが型ドキュメンテーション (クラスまたはインタフェース) で使用されている場合、true を返します。インラインタグについては false が設定されます。

戻り値:

このタグレットがタイプドキュメンテーションで使用されている場合は true、そうでない場合は false を返します。

isInlineTag

boolean isInlineTag()

このタグレットがインラインタグである場合は true、そうでない場合は false を返します。

戻り値:

このタグレットがインラインタグである場合は true、そうでない場合は false を返します。

getName

String getName()

このカスタムタグの名前を返します。

戻り値:

このカスタムタグの名前を返します。

toString

String toString(com.sun.javadoc.Tag tag)

このカスタムタグの Tag 表現を受け取り、文字列としての表現を返します。その文字列は、生成されるページに出力されます。

パラメータ:

tag - このカスタムタグの Tag 表現

戻り値:

この Tag の文字列表現

toString

String toString(com.sun.javadoc.Tag[] tags)

このカスタムタグの Tag 表現の配列を受け取り、文字列としての表現を返します。その文字列は、生成されるページに出力されます。このタグレットがインラインタグを表す場合、このメソッドは null を返します。

パラメータ:

tags - このカスタムタグを表す Tag の配列

戻り値:

この Tag の文字列表現